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Qt/Mac, the Mac OS X version of the Qt 
multiplatform C++ application framework, 
provides a uniquely unfair technological 
advantage in software development. Qt/Mac 
lets Mac developers develop in C++ on the 
platform they love most, while targeting 
additional operating systems, such as 
Windows or Linux. Qt/Mac also offers: 

■ fully object-oriented, elegant API 

■ single-source, multi platform development solution 

■ native compiling and applications that run at 
native speed 


Q 


TROLLTECH 


I integration with Project Builder, allow¬ 
ing developers to use Apple’s own IDE 
for editing, compiling and debugging 
Qt/Mac applications 

■ OpenGL support, for sophisticated 3D 
graphics on the Mac 

■ native look &C feel, such as the Aqua style 

Don't take our word for it. Visit us at 
www.trolltech.com/mac. Look at our list of 
Fortune 500 customers. Read what programmers 
say about Qt. Download the evaluation version, 
and see how easy C++ development can be. 


Qt /MAC: THE UNFAIR ADVANTAGE IN C++ DEVELOPMENT 

© 2003 TmlUecb AS, All trademarks, registered marks and service marfti are die property of their respective owners. All rights reserved. 

























YOUR DATABASE SERVER WITH THE 

C-TREE® SERVER SDK 



Today’s database demands are often too complex for traditional database servers. 
The functionality and precise level of control you need is simply nrtt 
Perhaps you need alternate son criteria for your data or a special iwisi i 
threading or communication logic. 


Enhance our server with your own 
custom server-side functionality 

Move functionality from Lhe client-side to 
the server-side Lo reduce network traffic 
and increase performance 

Modify or replace entire server 
subsystems 

Complete source for the server 
mainline, key server 
subsystems, and client-side 

Flexible OEM licensing 


FairCom’s c-tree" Server SDK allows you to create a 
industrial-strength server designed for your particular needs. Use 
FairCom’s kernel, with over 20 years of proven stability, or override 
functionality within specific subsystems to implement your own 
subLletics. Move your application’s data I/O functions to the 
server-side to decrease network traffic and increase 
performance! 

FairConTs c-tree Server SDK is used by companies 
worldwide such as Software AG and Citibank*. It’s 
integrated seamlessly into c-tree Plus and includes 
complete source code Us Lhe server mainline and all the 
interface subsystems to the e-tree Server. And 
best of all, once you’ve created your unique, 
customized server, it is easy to install and 
administer: no DBA required! 


Visit www.faircom.com/ep/mt/sdk today to take control of your server! 


USA_ 573 . 445.6833 

EUROPE +39.U35.773.464 

JAPAN_+81.59.229.7504 

BRAZIL +55,108723802 


DBMS Since 1979 * 800.234.81 BO • info@faircDm.qam 




%8 


9 FairCom 


w.fairco 


□thei' fltwnfisny and product names nre ragjGfcfinRfl trwlwnflris or iTRctawks nf their reeppftiw nwrrars 


© 3002 FsfCaon Corporation 









































Adaptive Server 
Enterprise 12.5 
MAC OS X 


HELPING FILEMAKER PRO CUSTOM 

SCALE TO NEW HEIGHTS 


Want to enhance the performance 
of FileMaker Pro on MAC OS X? 
The same database engine that 
runs Wall Street can help you do 
just that 


Sybase is helping today's 
leading companies achieve 

yji 

Information Liquidity: a highly 
profitable state where all of 
your information is transformed 
into real economic value. 


ASE T2.5 increases the reliability, 
availability and scalability of 
your FileMaker Pro application. 
It provides better data integrity, 
world-class security and the 
ability to handle thousands of 
transactions per minute. It'll 
also give your users the power 
of SQL queries. 


A FREE Developer's Edition 
download is available online 
at sybase.com/filemaker. 


ASE 12,5 for MAC OS X is yet 
one more example of how 


SYBASE INTEGRATION TECHNOLOGIES. EVERYTHING WORI 

















BETTER WHEN EVERYTHING WORKS TOGETHER" 


Tifldnnjvrlts tire the [mperty nf thelt rrsfwctivc owners. 
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STARTED 


Copyright 2003 by Dave Mark 


Getting Started: 
TinyViewer, Part Deux 


Last month's column was a hi of fun. So much so, that 1 was 
really torn on what to do in this month $ column. 1 really want 
to continue the iPtxl notes exploration. And I’ve been playing 
with these cool AppleScripts that I'm just dying to write about. 
Then there’s liny Viewer, the app from my May column. 1 really 
want to finish playing with Interface Builder and updating the 
TinyViewer interface. So that’s what I'm gonna do this month 
and we ll start on the other stuff next month, 

TinyViewer Recap 

In last month’s column, we used Interface Builder to 
build the beginnings of an interface for TinyViewer, our 
Cocoa update of the old PictViewer app. We used Project 
Builder to create a Cocoa Application project, then double¬ 
clicked on the MainMenu ,nih file to open the nib file using 
Interface Builder. 

We went through the four interface windows that appear 
- the app’s main window, the menu bar window, the palette 
window, and the window labeled MainMenu nih, which is a 
central repository for all the resources and instances from 
your project. 

We dragged out an NSlmageView from the palette 
window into the main app window, then used the dashed, 
blue lines to align and resize the NSlmageView inside the 
window. We selected Show Info from the Tools menu and 
used the Injh window to customize our NSlmageView so it 
was Editable and Enabled* Making it Edit able was especially 
important to our project as it allowed us to drag-and-drop an 
image on the window. 

We also used the Info window to set the Autosizing 
settings, so when we resized the window, the image resized in 
a pleasing way. 

Finally, we did the coolest thing of all. We used interface 
Builder to take the interface for a spin by selecting Test 
Interface from the File menu. I absolutely love this part of 


Interface Builder. They idea of prototyping an app, then test 
driving the interface, all without writing a single line of code, 
is amazingly useful, But beyond that, 1 love the fact that you 
can archive complex object hierarchies inside a .nib file, then 
bring them to life inside a completely different application. 
Think about this. You design and test the TinyViewer 
interface inside Interface Builder, then save the .nib file, 
wheel over to Project Builder, build and run the app, and the 
exact same interface appears. Again, all without writing a 
single line of code. 

Think back to your ResEdit days. You could edit the 
elements that made up the interface, even do a bit of 
stringing them together (though not much), but when it came 
time to bring them to life, you had to write a lot of code. Even 
though PowerPlant allowed you to create all the usual 
interface elements and nest them within nestable views, you 
still had to write the code that instantiated all your objects 
and brought them to life. 

Interface Builder brings this process to a new level And 
1 like it. 

Now What Do Wl Do? 

OK. so what’s next? Take a look at Figure 1. This is the 
menu that appears when you ask Project Bulllderto build and 
run the TinyViewer application. A couple of notes here. First, 
the most eagle-eyed among you might have spotted a slight 
discrepancy between the title of this menu and what you see 
on your screen, Nicely done. When you run your app inside 
of Interface Builder, Interface Builder actually breathes life 
into your objects and yields control. In effect, Interface 
Builder turns into your running app, until you quit. You’ll 
know this is happening cause your app T s menu title will 
actually say Interface Builder. 


Dave Mark is a long-time Mac developer and M acted contributor. Random fads about Dave? He is addicted to Age of Empires, He can't seem to stop 
camping. And his iPod has him hypnotized with its shiny silver grooviness. 
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Tiny Viewer 


File Edit Win 
About New Application 

Preferences.., 56, 


When the MainMenu window appears, start by double¬ 
clicking the left -most menu title, the one that says 
NewApplication, and changing it to say TinyViewer. 


Services ► 


Hide NewAppNcatteri 38 H 


Hide Others 
Show All 


0 MamMenu.nib - MainMenu 

; File Edit Window Help 

Figure 3 Editing the Tiny Viewer menu title. 


Quit NewApplication 

Figure I. Tiny Viewer's main menu. 


When you run your app in Project Builder, Project Builder 
actually launches your app. As you can see in Figure 1, tills 
version of TinyViewer features a Tiny Viewer menu, riddled with 
the generic name New Application. Let's change this menu to 
something a little more appropriate. 

Note that when you run your app under Interface Builder, 
the IB dock icon changes into a cool, single-pole, double- 
throw switch (va know, like the one Gene Wilder threw 
to bring life to Young Fmtikemtein). Quit the app and the 
old familiar IB icon returns. Since your app is not running 
as a separate process, there r s no separate dock icon for 
your app 

But when ProjectBmJder runs your app, youII Find your 
app represented by an elegantly designed dock icon 
distinct and separate from the Project Builder icon (and 
by elegant, I mean generic and boring, unless of course 
you’ve designed one yourself). 


Changing the TinyViewer Menu 

Quit your app if it is running, then (if you are not already 
in Interface Builder) double-dick MainMenu.nib in the project 
window {Files tab, Tiny Vie wer/Resourees) to open the .nib file 
in Interface Builder. Find the MainMenu,nib main window (see 
Figure 2) and double-click on the Main Menu icon. 


@00 MainMenu.nib 


1 instances ] 

j Gasses f Images 

[ Sounds 

/A 

% 

1 ! 

Fife's Ctanti 

Fiisi ffcsponckr 

MainMenu 

n 

Window 




A 

Figure 2, We MainMenu. n0? window, with MainMenu selected. 


Next, click on the menu title TinyViewer. A menu should 
appear. Find the three occurrences of NewApplication and 
change them all to say TinyViewer (see Figure 4). Make the 
same change to the single occurrence of NewApplication in the 
Help menu. 


© 


MainMenu.nib - MainMenu 


File Edit Window 


About TinyViewer 
Preferences... M t 


Services I 

Hide TinyViewer 36 H 
Hide Others JZXH 
Show Ail 

Quit TinyViewer 96 Q 

Figure 4* We complete TinyViewer menu. 



Change the Window Title 

Next step: close the menu window and click on the 
TinyViewer window to bring it to the front. Now select Show 
info from the Tools menu to bring up the inspector window. If 
you did this correctly, the inspector window will be titled 
NS Window Info. Make sure Attributes is selected from the 
popup menu and change the window’s title Lo TinyViewer As 
soon as you hit enter or dick out of the field, the TinyViewer 
window's title should change to TinyViewer, 

Very important! Be sure to save your .nib file in Interface 
Builder if you want to go back to Project Builder and test 
your changes. 

Figure 5 shows my copy of 7tny Viewer with a piemre 
dragged in and the Window’s Lille changed. In a future column, 
we re going to add some code to the project to change the 
window lirle to the file name of the drag-and-dropped image. 
Any idea how Lo do ihis? One solution is ro subclass 
NSImageView and insert your own dragging completion code. 
Well also add in an NSScrollView to make the NSImageView 
scrollable. This one is doable completely within Interface 
Builder if you want to take a crack at this yourself. 
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0 0 0 TinyViewer 





Figure 5 Tiny Viewer in action. That's Ryan getting rid 
of my hail . 


Create the About Panel 

In the olden days of Mae development, the About Box was 
a modal dialog box with some text in it. Over time, people 
started customizing these dialogs and, eventually, replaced the 
canned About Box with customized windows. Some (Adobe 
Photoshop, for example) even went so lar as to write their own 
custom window procedures, leading to odd shaped windows, 
sometimes with holes in them. 

Over time, the “official" method of producing About Boxes 
evolved, moving from Alxmt Boxes to About Windows to die 
current model, die Alxmt Panel. There's a terrific article on 
cocoadevcentral.com by Brock Brandeberg, that'll take you on a 
whirlwind tour of the nxxiem Afxnu Panel: 

hltp;//cocoadevcemralxom/arttdes/000071 .php 

I’ll give you the short version here, but definitely take a 
look at Brock’s article, Well worth the read. 

Just as the original Toolbox contained a canned routine for 
putting up an About Box, Cocoa’s NSApplication class contains 
a member called orderfrontStandardAhoutPanel: 

(void} orderFrontStsiid ardAbovt Panel ; ( id ) sender ; 

Tliis function is called automatically when About TinyViewer 
is selected from the TinyViewer menu (obviously, substitute your 
app name for TinyViewer}. OrderFmniStandardAhoutPaneh 
looks in your application's bundle for a set of elements it uses to 
build the About Panel. Alternatively, von can use the function 
orderFrontStandardAInmiPanelWithOptions: to roll your own 
Alxmt Panel at run time: 


Good doggie. 



Fetchsoflworks.com 


Version 4.0.3 now available. 
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- (void)otd^rFrontStandardAboutPanelWithOptitms: 
[NSMctiemary *JoptionsDictionary; 


This commenr is from NSApplicationA It describes the 
optionsDictionmy parameter, but is useful in understanding 
what elements you can add to your application's bundle (more 
on this below): 

/* optional keys in opliausDictionary: 

^•Credits*: NSAttributedString displayed in the info area of 
the panel. If not specified, contents obtained from 
"Credits.rtf* in [NSBundle mainBundlo] ; 
if not available, blank. 

@ w ApplicationName fl : NSString displayed in place of the 
default app name. If not specified, uses the value of 
CFBundleName (localizable), Fallback is |[NSFrocessInfo 
processlnfoj processName], 

fc'ApplicatioiiIcon": NSImage displayed in place of 
NSApplicationlcon. If not specified, use [NSTmage 
ima geNamed:@ ,, NSApplicat ion Icon " ]: if not available, generic 
icon* 

&*Copyright*: HSString containing the copyright string. If 
not specified, obtain from the value of 

NSHumanResdabieCopyright (localizable) in infoOictionary: if 
not available, leave blank, 

^Version"; KSString containing the build version number of 
the application ("5&.4*\ *l.Zd3*); displayed aa "Vetsion 
58.4" or "1.0 (v58.4) depending on the presence of 
ApplicationVersion. If not specified, obtain from the 
CFbundleVersion key in inf©Dietionary: if not specified or 
empty string, leave blank, 

@"ApplicationVetsion": NSStritig displayed as the application 
version ("1.0". "Mac OS X", "3\ "tfebObjccts . *.), 

before the build version. If not specified, obtain from 
CFBundlcShortVersionString key in inf©Dictionary., 


For starters, go into TextEdit and create your own About 
Panel text for Tiny Viewer* Save the file as Credits, rtf. Note that 
the name is case-sensitive and lias to be exactly Credits .rtf. The 
file Credits .rtf Xm. been used for About Panels since the birth of 
Mac OS X, Recent releases of the OS also recognize Credits.html 
and Credits.rtfd. Obviously, CredUs.btml allows you to include 
links in your About Panel and Credits, rtfd allows you to use an 
rlfd package. You can include ali three hies in your application's 
bundle, but priority is given to Credits.bimt, then Credits, rtf 
then Credits.rtfd. 

Why have more than one? Your best bet is to include 
Credits.rtf in case your app is used by someone with an old 
version of Mac 0$ X installed. Whether you supplement this 
with Credits.rtfd or Credits.html is your call. 

Adding Credits.rtf to the Project File 

let's add Credits.rtf ro our project. Once you get that to work, 
it's an easy step to add Credits.bind or Credits.rtfd to the mix. 

In the project window, select the Files tab, then make sure 
the Resources triangle is open. In die Finder, click on your 
Credits.rtf file and drag it into the project window, into the 
Resources area. As you drag, you'll see a bold black line appear 
that indicates where the file will lie dropped (see Figure 6). 


»ee 

VI %} V 15] i 

<§> Croups & Files 

▼ ^TlnyViewer 

► P Classes 

► 13 Other Sources 
fW Resources 

iS TinyViewer.icns 

N* K |H MainMenunib 

Sf fr lf} InfoPlist.striugs 

IF works 

r ® Producls 


Figure 6, Dragging Credits.rtf into the project file ~ 


W T hen you release your mouse button, the dialog in Figure 
7 will appear* Be sure to check die “Copy itema* checkbox at 
the top of the dialog. This tells Project Builder to copy die file 
into your project hierarchy. You can then do as you like with the 
original, cause Project Builder lets you edit the copy by double¬ 
clicking it. 


2! Copy items into destination group's folder (if needed! 

Reference Style: Default _ FI 

Text Encoding: Western (Mac OS Romani _ 5j 

© Recursively create groups for any added folders 
G Create Folder References for any added folders 

Add To Targets_ 

"8 © Tiny Vi ewer 


( Cancel ) f Add > 

A 

Figure 7 The Add File dialog, Be sure the “Copy items" 
checkbox is checked. 


Fill in the Bundle 

My Alert Panel is shown in Figure 8. Il is made up of a 
collection of resources, including an icon, a collection of 
info.plist strings, and the Cwdits,rtf file* You already know how 
to add the Credits.rtf file. To create your application's icons, 
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you'll want to use a program like Photoshop to create the 
artwork, then import that artwork into IconComposer . 
IconComposer is pan of the developer tools and is found in 
/Developer/Applications/. 
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Tiny Viewer 


TrfnyVtaww vtnten J.O 1 ^ 1 . 0 . 0 ) 


About TinyViewer 

TinyViewer was. writ ten by the tiny elf- 

peoples of NebulortT using Interface 
Builder, Project Builder, and a small pair of 
magnetic tweezers. 

Still reading this? Hrm. Gimme a nicker 


* 

* 


CopWighL 2 DQ 3 by Pjvu Milk All R^hli RiftferVcct. 


Figure 8. My TinyViewer About Panel , Hey! Wat s Kelley! 


Building an icon is entire column in itself. The key is to make 
sure you create an alpha channel for the 128-by-128 version of the 
fern, save as a tiff T then import into IconComposer. If your icon 
looks funky when you save and reopen ir t youVe probably not 
done the alpha channel magic properly. Well tackle this in a future 
column. If you want to try your hand at doing this, be sure to save 
the icon as a lens file, then drag it into the project, just as you did 
with Credits, rtf, 1 called my icon Tiny Viewer icm. 

Your next step is to click on the Targets lab in the Project 
Window, then click on the TinyViewer target. This will bring up 
a list of settings you'll need to edit in order to fill out the rest of 
your Ai>oui Panel, add an icon to the project, etc. Figure 9 
shows my settings. 
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Figure 9 IxnyViewer’s Jnfo.plist entries. 


Note that the CFBundleSignature is set to ChTs. I logged 
on to http://ctevebperapple.com and registered this creator 
code with Apple specifically for TinyViewer. Feel free to 
use this code yourself, since Ill only use it for Getting 
Started projects. Well dig into registering creator codes in 
a future column. 

Once those changes are made, go back to ihe Files tab and 
open the Resources triangle. Click on the InfoPlist strings item. 
You'll see something that looks like this: 

f* Localized versions of Jnfo.plist keys */ 

CFBundloName “ "TinyViewer" : 

CFfiundleShortVersionString = "TinyViewer version 1.0": 
CEBirndleGetInfoString = "TinyViever 1*0. Copyright 2003 by 
Dave Mark. All Rights Reserved.": 

NSHumanReadableCopyright = "Copyright 2003 by Dave Mark. All 
Rights Reserved.": 

Tve edited my versions to reflect the settings I want lor 
liny Viewer, Note that the InfoPlist strings file is your localized 
strings file. You might contract out to a localizing firm to take 
your English plist file and translate it to a German plisi file. 
You'd keep both localized files in your project and the right 
strings would be displayed, depending on the language setting 
on your computer* 

Think of the Info plist file as the true repository Tor your 
plist keys. Any strings that need to be localized should be kept 
in each localized InfoPlist.strings file. The localized version, if It 
exists, will override any matching key in tiie Infoplist file. When 
building your project, just do the Targets version first, then do 
the Files version and you should be fine. 

A couple of books that really helped with this month's 
column: Joe Zohkiws excellent Mac OS X , Advanced 
Development Techniques really digs deep into a wide 
variety of Cocoa-related topics. And, as five mentioned in 
a previous column, Bill Cheeseman 's Cocoa Recipes for 
Mac OS X ■ The Vermont Recipes is an invaluable 
resource. I definitely owe both these guys a beverage of 
their choice. And an extra tall one for Mike Trent for 
helping to unravel all those pesky Cocoa mysteries. 
Thanks! 


Tell Next Month. *. 

Man. 

There was way more that I wanted to get into. 1 jusL ran out 
of space, 1 am just loving Project Builder, Interface Builder and 
Cocoa. Noi sure what well dig into next month. There’s a little 
more iPod madness left in me* 1 also just got this really good 
AppleScript book. Hrm. Maybe a column on scripting my iPod? 
See you soon*,*© 
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REVIEWS 


By Ron Davis 

Book Review: Mac OS X Advanced 
Development Techniques 


I have to confess LhaL I worked wilh Joe Zobkiw r on my firs! 
job out of college working on Virex almost ten years ago, I was 
one of the tech reviewers for his previous book A Fragment of 
Your Imagination, which covered the esoteric programming arts 
of init T edev, and other code fragments. It was one of those 
books that covered stuff no other book covered, the really low 
level crap most of os attempt to avoid. At the time there was next 
to no documentation on coding these things and Zohkiw’s book 
was written to meet that need. 

Mac OSXAdvanced Development Techniques (MADT) is like 
that book. Not that it talks about the stuff you are try ing to avoid 
writing, but it is talking about the things no one else is, There isn't 
as much low level stuff you can mess with in OSX, but there are 
a lot of little nooks and crannies of code that need explanations. 
Need to write a System Preference panel? Irks there, llow about 
adding one of those system-wide menus? Got you covered. 
They’re called Status Items, Chapter 9. Screen saver? Chapter 10. 

It also covers some less stand-alone stuff like threads, 
frameworks and how to talk between a Cocoa app and a command- 
line tool. There is also a good chapter of "snippets", little pieces of 
code you often want, but that don't merit a long discussion. 

Section 1: Overview 

In my opinion, this book is really aimed at the experienced 
OSX developer. The introduction says anyone who can compile 
a program in Project Builder can use it. I think you probably 
need a little more experience than that. I was interested in the 
book as a follow' up to the various OSX development books I 
already had. If you have no understanding of Cocoa and want 
to write a screensaver, this book may not l>e the place to start. 
Given the level of experience required for the ixx>k, i 
thought the first chapter was a waste of time. It is a very high level 
overview of MacOS in general and MacOS development. Most 
people already know about Quartz, Project Builder, FreeBSD. 

The second chapter at first looked like more of the same, 
but I found die brief descriptions of die all of the developer 
applications helpful, if a little shallow, Especially interesting was 
the listing of command line tools useful to the developer. 

Another general thing about the book. Zobkiw is a long 
time developer of Mac software and this book is plainly written 


assuming you are coming from a Mac background. If you’re a 
Windows user or a UNIX guy, some stuff might go right by you, 
but none of it is really critical 

Section 2: Application Level 

llie first chapter with code in it is a document-based Cocoa 
app. This isn’t a simple text edit style doc app either, but an app 
that watches Doppler radar pictures on the web and alerts you 
when a color in them change, I like that. I don’t need another 
simple simple application, ! want something that shows me a lot 
while it leaches the basics of a document based app. 

The lxx>k also doesn't go through creation of the project step 
by step, but assumes you downloaded the project and just need 
it explained to you. This is appropriate for an advanced audience. 

Ilie only problem 1 had with rite app was die document 
class uses readFromFile:ofType: and writeToFile:ofType instead of 
dataRepresentationOfType: and loadDataRepresentation:ofType 
which are what the standard document template creates for you. 
Nor does he mention these other routines and explain why one 
would be belter or worse than the other. 

The nexL two chapters discuss plug-ins, both Carbon and 
Cocoa, it is a very useful overview and explanation of how the 
various plug-in architectures work in OSX. 

The last chapter in this section covers Frameworks, 
showing how to build both a Carbon and Cocoa version of a 
simple Framework. 

Section 3: Enhancing the System 

The second section of the honk was advanced topics for the 
application writer. The third section covers how to build unusual 
non-applications. Specifically System Services, System Preference 
Panes, Status Items (system-wide menus), Screen Effects (screen 
savers), and Color pickers. 

You’ve probably noticed the Services sub-menu of a lot of 
apps. Under 10.1 this was a dead give away you were using a 
Cocoa, but 10,2 made them available to Carbon apps as well. 
They are programs, normally faceless, that interact with the 
current selection, Zobkiw explains how to write one of these 
services, creating an example that changes the ease of the 
selected text. 


Ron Davis is a long time Macintosh Software Engineer, having worked for companies like Apple, and Metruwerks on a variety of products From development 
tools to anti-virus software His day job is working for Also ft, and his evening job is HAD, Productions, makers of Suck It Down and FlndcrEye. 
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Next Zobkiw talks about how to write a System Preference 
panel. This allows you to provide a basic U1 for faceless 
application that run all of die time. The example in this chapter 
sets the preference for the Service created in the previous chapter. 

Zobkiw gives an informative discussion of the various kinds 
of little menus that are displayed in the menu bar on the right 
side. Some of these are Status Items, some of them Menu Extras. 
Technically, we developers are only allowed to create Status 
Items; Menu Extras are reserved for Apple. The example in this 
chapter is of a Status Item and not a Menu Extra. 

I was always a little jealous of how Windows has a standard 
screen saver mechanism and 0S9 didn’t. Well that changed In 
OSX and now you can very easily write those screen savers 
yourself. They're so easy the chapter explaining them is only 7 
pages long. It is still a good introduction that leaves you with a 
place to starr writing your own. If you are going to do a lot of 
Screen Effects work, you will want to get Saver Lab 
(hUp://www.d07ingcat,C0m/) f which allows you to run your screen 
saver in a window for debugging. 

The last esoteric piece of code in this section is a Color 
Picker. The OSX Color Picker is actually a collection of pickers. 
When you open it there is a list of icon buttons at the lop of the 
window that lei you pick from a number of pickers. Third party 
developers can create their own picker panels using Cocoa. 
Chapter 11 gives you the details on how to do this. 

Section 4: Advanced Methods 

Threads is the first of the advanced topics discussed, which 


gives you an overview' of what threads are and how they work, 
and gives you an example of how to use them. 

Terminal is the name of the next chapter, but it is really 
about NSTask and another thread example. Of all the chapters, 
this was the one 1 liked the least, because 1 felt it didn’t really 
cover the topic and was just kind of wrong. He tells you how to 
use an NSTask to launch a UNIX command line command, but 
when he does one that you have to wait to return, he uses a 
thread that polls for die result. It really should have used the 
notifications NSTask has built into it. Thai is the right way to do 
it and the code would have been simpler. 

The last two topics covered by their own chapters were 
XML-RPC and SOAP. These chapters give a basic introduction to 
using WchServices both in PHP and Cocoa, The PI IP for the 
server made sense, though I was a little surprised Zobkiw did a 
PHP diem. He also builds a client in Cocoa using the 
WcbServices API in CoreServices. These two chapters are very 
similar. If you have a preference for one remote procedure call 
methodology over the other, you probably only need to read 
one of these chapters. 

The last chapter of die lxK>k is a collection of snippets. Bits 
and pieces of code that you will find useful, hut don’t rate a full 
chapter. This may be the secrion you find most useful. 

Summary 

Overall I would say this book is a must have for a complete 
Cocoa bookshelf It covers Lupics no other book covers and does 
it in a concise, referenoeable way. 
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COCOA 

DEVELOPMENT 


by Wolfgang Ante, Vienna, Austria, 


Using Rendezvous 


How to discover and publish services on 
the LAN 


What is Rendezvous? 

To start with a buzzword: Rendezvous is zero-con fig 
networking. That means using Rendezvous you should not have 
to set up any server addresses, user names, and such to access 
and use services on the local network. Just use them. Apple 
users not switching over from Windows recently already know 
tills: AppleTalk supported zero-con fig networking from the 
beginning. So why is Rendezvous letter? 

FirsL, Rendezvous is based on IP networking. IP is the 
industry standard, the Internet protocol, and has far less 
overhead than most other protocols. On the other hand 
AppleTalk is a proprietary protocol with a lot of overhead, 
making it more expensive and slower. 

Second, Rendezvous is open. The source code is available 
for download and you may include it into your software for free. 
You will not need this as long as your program is mnntng on 
Mac OS X only. But ibr developers on Linux and Windows this 
means they can use Rendezvous, too. If you take a look at the 
Rendezvous mailing list you can easily see that they do. 

Publishing and browsing services 

When your applications wants to provide a service on the 
network you will have to publish it, when you want to use a 
service published by someone else you will have to browse for 
services. A service is whatever you want it to he. Rendezvous is 
just helping to announce and find services, li gives you all you 
need to connect, namely the IP address and port number, but 
doesn't setup the connection itself. 

Cocoa gives you a very powerful way to connect to other 
Cocoa applications on the network called Distributed Objects, 
My next article will be on Distributed Objects, but for now let's 
get into the details of using Rendezvous in code. 


Goals 

t noticed that Rendezvous is not widely adopted yet, and 
after working with it myself 1 think 1 know why: You still have 
to care about a lot of things you are not very much interested in, 
even in Cocoa, Don't gel me wrong, I think the Cocoa API to 
Rendezvous is very good, but for 90% of the applications that 
could use Rendezvous it would lx: very handy to have something 
that gives you just two things, The ability to publish a service and 
to browse for others who published the same type of service in 
one easy to use class. 

This article will show you how Rendezvous works and 
additionally will give you a simplified interface (the 
ARendezvousControiler class) that you are free to use in your 
software, Using Rendezvous will open your application for 
teamwork. Think about it, in a lot of applications it makes sense 
to connect and communicate! 

Overview 

Cocoa gives you two classes for the two main objectives: 
NSNetService to publish services and NSNelServiceBrowser to 
browse published services. 

Because network operations may take some time to finish, 
both classes use the concept of delegation to keep your 
application responsive. You ask for what you want and continue. 
As soon as the information Is available your delegate will be 
notified alx>ui the found information. This also solves the 
problem of dynamic changes, when services are published or 
removed later on. Every time the situation changes your delegate 
will l>c notified. 

There are quite a lot of delegation methods that make 
understanding the API confusing at first. I will try to concentrate 
on a typical flow of information, if you are interested in the 
complete list of delegation methods later, 1 recommend using the 
freeware “AppKiDo" from Andy Lee. It is a very good Cocoa API 
browser, I could not live without it anymore, it is available at 
<http://homepage.mac.com/agJee/downloads>. 


Wolfgang Ante is the founder of ARTIS Software (http://www.arti5Software.com), In the last H years he worked on Macintosh products for ARTIS and lots 
of other companies, including a product dial won the Macworld's Editors Choice Award At tile time he is trying hard to transform ARTIS into a 
successful Mac OS X shareware company. Beside that he is always liappy to offer his experience for working on your project. You cun reach him at 
wolfgang@arttssoftware.com. 
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Publishing 

Publishing a service is quite easy. You create a service by 
creating an object of type NSNetService, set die delegate and 
publish the service. Listing 1 shows this: 


listing 1: 

Puhfahtng 

NSNetService * service: 

NSStrin^ ‘publishedNaine: 

lot portNumber; 

service -■ [{NS'NetService alloc] initVith£lomolii:@ ,,ir 
type:$*_SF.rvicetype ( tcp." 
name: publ1 shedName 
port;portNumber ]i 
[service setfleleaate:delegate]; 

[service publish!; 

To publish on the default domain (which is die local 1 
domain, i.e. your LAN) you pass an empty string to 
inilWithDomain. type is an identifier Lor the kind of service you are 
publishing. The naming convention for this is *_servicetype, tcp.” 
where you replace servicelype with your identifier. The type is 
usually nut visible to the user, so lie as dear or obscure as you 
like, name identifies your service to the network and must 1>e 
unique. The name usually is visible to the user. Finally port must 
contain a port number you already acquired for the service. 

setDelegate sets the delegate, this is the object that will lie 
notified later publish will start the process. As soon as you 
publish your service it will broadcast its presence on the network. 
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Tile only interesting delegate method at this point is 
netService:didNotPublish:, This will be sent to your delegate 
when die service could not he published, otherwise you can 
assume that your service has been published and is visible to 
others now. 


Browsing 

Browsing for services is a bit more complicated. You start 
by creating an object of type NSNetService Browser, set die 
delegate and start browsing. Listing 2 shows this: 


Listing 2: 

Start browsing 

NSNetServiceBrovser ‘browser; 

browser = [[NSNetServieeBrowser allocl initj; 

[browser setDelegate:self]; 

[browser searchForSorv 1 cfcflOfTypesarvicetype._tcp.* 
i&DQiaaito@ ,,w l ; 


First you create the object and set the delegate to be 
notified, then you start browsing by asking for services of the 
type you are interested in. As before pass an empty string to 
browse in the default domain. 

Again the requested information will l>e sent to your 
delegate later. The interesting ones that will be sent to you at this 
point are netServic©Browser:didFindSemce:moreComing: and 
netServicGBrowser:didRemoveService:moreComing:. Rendezvous Is 
dynamic, so services will show up and go away from time to 
time. As long as you do not stop browsing, your delegate will 
receive these messages every time something changes about the 
availability of serv ices of the requested type on the network. 

Lets stan by looking at 

netServiceBrowser:didFindServic©:moreComing: Listing 3 shows 
an implementation: 

Listing 3 1 

Service found 

- fvoid)netServiceSrowser: 

(NSMetServiceBrowset ‘JaNetServiceBroVSer 
didFindService:(NSNetService 1 )aNetService 
moreComi ng: (BOOL)noreComing 

I 

[aNetService set Del coat©: sol f] ; 

[aNeiServicc resolve]: 

I 


You receive three parameters: aNetService Browser is the 
browser that sent the message, aNetService is the service that has 
been found and moreComing lells you if there are more queued 
service objects. The moreComing parameter looks a bit strange 
at first, but can lx; used as a hint to your user interface code to 
delay updating. 

The information you are probably most interested in comes 
as the second parameter and it looks like this is already 
everything you need. Unfortunately you only get one third of die 
information you are interested in. You can send the service 
object a name message to get the name of the service. To obtain 
the IP address and port number you have to set a delegate and 
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send a resol vg message to the service. Don't foiget to set the 
delegate, since tills ilrne the service will sent you messages, not 
the browser. When you send resolve this will again result in 
messages sent to the delegate. The interesting one this time is 
netServiceDidResolveAddress:. 

Following the successful path lets start by looking at 
netServiceDidResolveAddress:. Listing 4 shows an implementation: 

Listing 4: 

Addresses resolved 

■ (void)netServiceDidResolveAddress:(NSNetService *)sender 
t 

NSStrieg ‘name = nil; 

NSData Address = nil; 

struct sDckaddr_in "socketAddress = nil; 

NSStxing *ipString & nil; 

int port: 

for (1 - 0; i < [[sender addressee] count]; I++) 
i 

unme ” [sender name]; 

address = [[sender addresses] objectAtlndex:i]; 
socketAddress * {struct sockaddr_in *} 

Laddress bytes]; 

ipString - [NSString stringUithFonaat: 

inet_ntoa UocketAddrgss->sin_addr)l ; 
port = soeketAddreGS’>flln_portj 

r-..] 

i 

] 

The only parameter is the service object that sent the 
message. Now the service object holds all the needed 
information Lo connect Lo Lhe service. You obtain the name by 


sending a name message to the service. To find the IP address 
and port number you send an addresses message to the 
service. You receive an array containing all addresses. This 
array usually contains exactly one address, but to be on the 
save side loop through all addresses in the array. An address is 
of type sockaddrjn. This is a standard networking structure of 
Unix, See the above code for the details. After you have the 
name, IP and port you are ready to use that information. You 
will probably store the information in an array so you can 
access it any time you need it, 

Lets go one step back to 
netServiceBrowser:drdRemove3ervice;moreComing:. This message 
will be sent to you every time a service has been removed, if 
you stored the information in an array you have to remove the 
entry for that service to keep the array up-to-date. 

Browsing problems 

On Mac OS X 10,2.3 and before there is a problem with 
service browsing and switching locations. When you switch the 
location from the Apple menu (or change your IP address in any 
other way) the browser gets seriously confused. Your old and 
new IP may or may not show up. You rnay get entries that are 
simply wrong, pointing to your old IP address. 

This happens with Apple’s Rendezvous-enabled products, 
too. I saw myself showing up in iChat double after switching 
back and forth and Apple's AFPServer (the ’Personal File Sharing* 
server) also has problems with it, when you look at your logs. 
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El might be thui this is already fixed wlien you read this, 
since Apple has released fixes to Rendezvous with every of the 
last three system updates. 1 read it is much better with Mac OS 
X 10.2.5, but to be nice to your users you should try to offer 
them a workaround on systems before 10.2.5 at least. 

My suggestion is to offer refresh functionality. A refresh 
starts a complete new search forgetting about the cached entries. 
If you want to automate this, you could regularly check 
if your IF address has changed (use [[NSHost currentHost] 
address] for this) and then refresh. The 
ARendezvousController class does not do this, but it offers a 
retreshBrowsing method that you can hook up to a button in 
your user interface easily. 

Making things easier 

By now you have a gcx)d overview of how to use 
Rendezvous. Rut like me, I guess you will think that you don't 
want to weave that all into your code every time you want to 
use Rendezvous, 

Therefore I came up with ARendezvousController. U has a 
simplified interface and still provides everything to publish and 
browse services. An ARendezvousController object cares about 
one service type, publishing and browsing it. It provides 
stait/stop methods for publishing and browsing. It has exactly 
one delegate method that is called every time something 
changes. It keeps track of the found services and on request 
returns an array with all found services, ready with name, IF 
address and port number. It even creates the socket others will 
connect to for you. 

Listing 5: 

Public interface of A UcndcftmrcOim roller 

// public interface 

Winterface ARenduzvousController : NSGbjett 

■ (id) initWi thName: (NSStrlng *)natne type: (NS St ring, *)type 
port:(1ntjport; 

(void)dealloc: 

- (id)cfelegate: 

- (void)setDelegate:(id)object; 

- (NSString *)name: 

- (BOOL)setName:(NSString *)nane; 

- (NSSocketPart *)socket; 

(void)activateBrowsiEtg: (BOOL) flag: 

(BGGLHsBruwsiug; 

(void)refreshBrov&ing: 

- (void)activatePublishing;(BOQL)flag; 

- (BOOL)isFublished; 

- (NSArray *)discoveredServicefiWithlnfo; 

- (NSString *) ipForName: (NSString 'Jnamf?; 

UntlportForNainr: (NSString *)name; 

@end 

// to be implemented by die delegate 

^interface NSObject (RendezvousControllerDelegate) 

(void)di&covercdServicesDidChsnge:Hd)sender: 

@end 


Using ARendezvousController 

Instead of going through the list method by method, lets 
start with a real world example. The following code will fill an 
NSTableView with all available services of type ® h _dem 0 .Jcp," 
on your local network, 'the table view will be updated 
dynamically every time services are published and removed 
withoul user intervention. Just like you know it from iChat, 

The complete demo project including 
ARendezvousController can be downloaded from 
<http://wvwv,aUissoftware.com/rendezvous>. This is probably the best 
way to proceed, since you don't have to create the .nib file in 
Interface Builder yourself. 

If you are reading this without access to the Internet, here 
Is what you need to create in Interface Builder: The main 
window contains an NSTableView. The NSTableView has three 
columns. The identifiers of ihe three columns should be "name", 
V and "port 1 '. 

Listing 6: _ 

ADemo Controller b 

Wintertace ADemoController : NSObject 
l 

IBOutlet NSWindow *_mainWindow; 

IBGutlet NSTableView # _tableViev; 

ARendezvousController * rendezvousController; 

NSArray *_lagtState; 


- (void)awakeFromNib; 

- (void)discoveredServicesflidChange:(id)sender: 

{int) numberOfRowelrtTableView: (NSTableView Stable View: 

- (id)tableView: (NSTableView UtableView 
objnctValueForTableColuitin : (NSTahleColutiui *) table Column 
row: (int) row; 

Send 

In Interface Builder import this header file and connect the 
jmainWindow outlet to your window and the jableView outlet to 
your table view. 

Lets start by looking at awakeFromNib, This methods 
contains all the necessary setup: 

Listing 7: 

awakeFromNib 

(void)a wa ke F r omNib 

( 

JLastState = [[NSArray alloc] init] : 

_rendezvous,Gont roller - [[ARendezvousController alloc] 
initWithName:KSFullUserName() type:@"_d erno*_t cp * * 
port:12345]* 

[ .randezvousController setDelegateiself]: 

[ rendezvousController activateBrowsing:YES] ; 
Lrcn.do7.vousController acti vatePubl ishing: YES] ; 

L_mainWindew center]; 

[_mainWindow makeKeyAndOrderFront:self]: 

) 

JastState will contain a copy of the last state returned by 
the rendezvousController. In the beginning there are no services, 
so it is initialized as an empty array. After that the 
ARendezvousController is initialized with a type of 
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@"jdemo,_tcp." and with port 12345. The pon number is just a 
suggestion. If this port is already in use the number is increased 
as long as a socket can be created. This is no problem, since the 
port number is published. At this time the socket will be created. 
To obtain the socket you would send a socket message io the 
rendezvousController. Finally the delegate is set to self so we are 
notified of changes, browsing is started by sending 
activateBrowsing: and the service is published by sending 
activatePublfshing: to the rendezvousController. 

F fhe next method is the delegate method. 

listing 8 : 

The delegate method 

- (void)discoveredServicesDidChange: (id)sender 
I 

L^astState autoralease]: 

_lastState = [[rendezvousController 
discoveredServiccsWH hTrtfo] retain] : 

LjtableView reloadDaLa]: 

\ 

It simply releases the old copy of states, asks the 
rend ezvousC on trailer for an up-to-date array of states and retains 
that. After that it tells the table view to reload its data. 

Finally these two methods fill the table view with data: 


(Id)tableView:(NSTableView *)tableView 
objectValueForiableColumn: (NSTableColumn *) tableColuHin 
row:(inrj row 
f 

return [[_lastState objectAtlndex:row] 
valueForKey; LtabieColuwn identifier]]: 

) 

The last one is a wonderful demonstration of applied Cocoa 
magic, but to understand it you should know first that the array 
returned by discovererfServicesWIthlnfo contains an NSDictionary 
for every service. Such a dictionary contains three key/value pairs: 
Key "name 11 contains an NSString with the name of the service 
Key M ip' r contains an NSString with the IP address (like 
@'T92.168,0. D 

Key "port" contains an NSNutnber with the port number 

By setting the column identifiers of the tabic view to these 
keys the data can be fed to the table view with this one-liner. 
That’s it! It is that simple. In my next article I will show how 
to send messages over the network just like you would send it 
io your objects. This is called Distributed Objects. Stay tuned! 

Listing 10; 

ABendeyvousOontm] ler. h 

//import (Foundation/ Foundation. h> 


Listing 9: 

Table view methods 

(1 Tit)ntitnberOfRows!nTableVf ew: (NSTableViaw OtableVlew 

I 

return LlaatState count]: 

] 


Presto Vivace , Inc. 

Fast and Lively Public Relations 

Presto Vivace specializes in public relations 
for small technology companies. Our press 
contacts database is now available for 
companies to manage their own publicity. 

For only $99, you can use our professional 
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marshall@prestovivace.biz for sample. 

4902 Powell Road, Fairfax, VA 22032 
703/426-5876, fax 426-5892 
http://www.prestovivace.biz/ 


// interface of the rendezvous class 

^Interface ARondezvoueController ; NSQb-ject 

I 

NSNetService *.service; 

NSString ".serviceNante; 

NSString *_serviceType; 

BOOL _browsing: 

BOOL .publishing: 


HSMetServiceBrotffier *_serviceBrowser: 
NSNe LSc rvic eB rowse r * _doma \ nBtov&erj 


NSSocketFort 

int 


*_socketPort; 
_portNumber; 


NSMutableArray 


.discoveredServicesWithlnfo; 


Id 


delegate; 


- (id)initWithNaae;(NSString f )name type:(NSString ’Jtypc 
port:(int)port; 

- (void)dealioc; 

- (id)delegate; 

(vo1d)aetBelegate:(id)object; 

(NSString *)namc; 

- (BOOL) eel Name: (NSString Mtume; 

(NSSocketFort *)socket; 

- (void)activateBrowsing:(BOOL)flag: 

- (BOOL)ieBrowsing; 

■ (void)refreshBrowsing; 

{void)activat ePublish i n g:(BOOL)fla g; 

(BOOL)isPublished; 

(NSArray *)discoveredServicesWithlnfo; 

- (NSString *)ipForNsme:(NSString ‘Jnmae; 

- (int)portForName:(NSString V)name; 

@end 

// to be implemented by the delegare 

^interface NSObjecl (RendezvousControllerDelegatc) 

- (void)discove reds ervie esDidChange:(id)sender; 
tend 
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Listing 11: 

ARtcdczvi > usG jntrolkr.m 

# 1 rapo rt "AR**nde?.votisCont rol ler * h # 

irlnclude <ne Li.net/in. h> 

^include <arp£i/inet ,h> 

©interface ARendesvousCemtroller 
(ARendezvonsControlleeInternal) 

// creation 

(void)creatoSocket; 

(vpid)createBrowser; 

- (void)createService; 

if management 

- (BOOL)addlttfoService;(NSNet Se rvice *) 

service name :(NS Stting *)name ip:(NSString *)ip 
port:(Intjport: 

(BOOL)removelnfoService:{NSMctServIcc *)service; 

// other 

- (void)starts rowsing; 

@end 

Blnterface ARendezvousControl Ter (NSNetServir.eDelegation) 

// publication 

■ (void)netService; (NSNetService *)sender 
didNotPublish: [NSDictionary 1 ) errorMct: 

- (void)netServiceWIllPublish:(NSNetService *)sender: 

- (void)netServiceDidStop:(NSNetService l )sender; 

if resolution 

{void)nctScrvice:(NSNetServicn *)sender 
didNotResolve: (NSMciiotiiity *) crrorDiet: 

■ (void)netServicei)idKesolveAddress:(NSNe tService *)sender; 

- (voidJnetServiceWiilResolve:(NS8etService *)sender: 


£end 

@interface ARendezvoueController 
(NSNetServiceBrnvserDelegation) 

// browsing 

- (void)netServiceBrowser;(NSNetServiceBroweer *) 
aNetServiceBrowser didFindService:(NSNetService “) 
aNet Service EnoreComing: (BQQL) more Coming; 

- (void)netServiceBrowser;(NSNetServiceBrowser *) 
aNetServiceBrowser didNotSearch:(NSDictionary MerrorDict; 

- (void)netServiceBrowser;(NSNetServiceBrowser *) 
aNetServiceBrowser didRemoveService:(NSNetService *) 
aNetService moreComieg:(BOOL)moreComing; 

- (void)netServiteBrowser;(NSNetServiceBrowser ') 
aNetServiceBrovser didFindDamain; (NSStriug *) dmnuiriSLriiig 
moreComing:(flOOL)moreComingr 

- [void)netServiceBrowser:(NSNetServiceBrowser *) 
aNetServiceBrowser didRemovsDomain;(NSString *)domainstring 
moreComing: [BOf)L)moreComing; 

(void)nelScrvicoBrowGerHidStopSearch 2 
(NSNetServiceBrowaer *)oNetServiceBrovser; 

- (void)netSefviceBrowserWillsearctu 
(NSNetServiceBrowset *)aNetServiceBrowser; 

£and 

ripl omen t at i on ARond 07 , vousConr rol 1 er 

(id) iniiWiLbNanie : (NSSt r i ng Mnamc type: (NSSfr r i ng *) type 
port:(int)port 

\ 

seif - Lsuper initj: 
if [self) 

I 

if store name, type and port tor later 

[self sctNamo;name]; 

_serviccTypc " [typo, retain]: 

_portfJumber = port: 
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// Initialize array 

„diaeaveredScrviciMiWf thfnfa ^ 
l [NS Mu tab l oAr ray alloc] init]; 

// create the socket and the browser 

[self createSocketj : 

[self createBrowset]; 

) 

return self; 

I 

(void)dealloc 

I 

// clean up 

[self activat©Publishing:NO]; 

[„servit©Browser stop]; 

[.dcunainBrowser stop]; 

[. socketPort release] : 

[.discoveredE g rvieosWithTnfo release]; 
[super deailoc]; 

I 

- (id)delegate 

I 

return delegate; 

\ 

(vold)setOnlegate;(Id)object 

// find if delegate Supports I he delegation message 

if {! [object respondsToSeiector: 

iselectortdiscoveredServieesDidChange:)]) 
NSLog (@"Delegate does not respond to 
'diflcoveredServicesDidChange: 1 !*); 

.delegate ” object; 


(NSString *)naroe 

( 

return serviceNaroe; 

I 

(BDOL)sci Nfltnei (NSString # )nnme 

t 

// change name only when mu already published 

if (1.publishing) 

I 

[name retain]; 

[ servieeKaine release]; 
serviceNatto ' name: 
return YES; 

] 

else 

I 

NSLog (e*Cannot change name while service 
is published!"); 
return NO: 

1 


(NSSocket Pori *)socket 
return .socketPort; 


(void)activat©Browsing:(BOOL)flag 

// if requested ami amyl state match tkm't proceed 

if (flag ** .browsing) 
return; 

if (flag) 

I 

H activate browning 
.brcwBlng * YES: 

[„sc r v i c e Brows©r sea r c hForSe r v ic esOfTy pe: 
_serviceType inLoinain:@ rt *] : 

else 

I 

// deactivate browsing 


_browsIng = NO; 

LsorviccBrowsdr slop); 

LdiscoveredServlcesWithlnfu reaioveA 11 Objects] ; 
[.delegate discoveredServicesUidChange:self]; 


- (BOOL)isBrowsing 

I 

return .browsing: 

I 

- (void)starthrowsing 

f 

// should only be called when browsing off 

if f_hrowsing) 

I 

NSLog (fl*Browing already started!*); 
return; 
l 

// start browsing 

^browsing - YES: 

LserviceBrowser searchForServlcesOfType: 
serviceType inDoaain; 

I 

(void) refreshhrowaing 

I 

// don’t refresh if not browsing 

If ([.browsing) 
return; 

// sta ft/stop 

// (stop is deferred to the end of message queue) 

[self activat©Browsing:NO]: 

[self perfarmSelector:#selector(atartBrowsing) 
withQbject:nil afterDelay:0.Oj ; 

I 

(void)activate Publish trig:(BOOL)f]ag 

// if already activated then don't do anything 

if {.publishing = flag) 
return: 

if (flag) 

I 

// activate service 
[self crcatcService]: 

I 

else 

I 

// deactivate service 

Leer vice stop]: 

.service = nil; 

I 

// set new state 

.publishing w flag: 

} 

- (BOOL)isPublished 

f 

return .publishing; 


(NS Ar t ay *) d 1 sc ov er ed Sc r v i c e s Vi t h I rif o 

I 

// tttttfn (autorclemd) copy 
return [NSArray 

arrayWithArray:_discoveredSetvicesWithInfo] ; 

I 

(NSString *) ipForNamc; (NSString 'loam© 

NSEmmerator * e “ nil; 

NSDictionary 'diet & nil: 

// rind the corresponding ip to the given name 

e = f niscoveredServlcesWithTrifo objectEmjinerator]; 
while (diet “ [e nexTObjectJ) 
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if ([[diet objeciForKey t^nanne"] 
isEqualToStritig:naine] 3 

return [diet obj ec tier Key ; 

// return nil when not found 

return nil: 

} 

- {int)portForNaHie: (NSString *)naine 

NEjEnusnerator *e = nil; 

NSDictionary 'diet s nil; 

// find the corresponding ip to the given name 
e - T dlscoveredServicesWlthlnfo objectEnunicrator] ; 
while (diet ■ [e nextobjcct]) 

Lf ([[diet objectFoeKey^"name"] 
isEqualToSt ring; name]) 

return [[diet objectForKeyr£ rt port ,, j intVaiue]; 

If return 0 when not found 

return 0: 

J 

Send 

§1 tup 1 ementation ARendezvousController 
(RendezvousControllerlnternal) 

- (void)createSocket 

\ 

ff already there 

If {.socket.tort) 
return; 

// look lor free port 

while (LsocketPort) 

l 

.socketPort = [(NSSocketPort alloc] 

InitWHhTCFPort:_portNumber] ; 

_portNumber++: 

) 

_portNumber--: 


* (voidJcreateService 

( 

if already there 

if (.service) 
return; 

// create service, nuke self the delegate and publish 

^service - f [NSNetService alloc] ini rWi thDomain:#*" 
type; snrvlceType name: .serviced me port :„portNumber] : 
[.service ecrDclcgateiself]; 

[.service publish ]X 

\ 

(void)createBrowser 

f 

// setup service brow ser 

If [! serviceBrowser) 

l 

_serviecBrawser - [ [NSNetServiceErowser alloc] 

inlt]: 

[_serviceBrowser setDelegate;self 7 ] ; 


- (BOOL)addlnfoService: (NSMetService •Jnervice name;(NSString 
*)name ip:(NS$tring *)lp port;(int)porL 

NSMutableDictionary ‘diet = nil; 

NSEmimerator *e = nil: 

if if already there then don't add 

e “ LdiscoveredServicesWithlnfo objectEnuneratar]; 
while (diet - [e nextObject]) 

if ([[diet objecttorKey: 0 ”ip"] isEqualToString:ip]) 
if ([[diet objectForKey:@ - port B ] intVaiue] “ 
port) 

return NQ; 


// add if not found in array 

diet = iNSMutableOictionary dictionary]; 

[diet setObject:ip forKey^ip*]; 

[diet setObj ect: [NSNumbe r numberWithlnt: port ] 
forKey: ©"port" 1 : 

[diet setObject:name forKey;# ,t naI^e ,, ]: 

[diet setObject: service forKey service* ] ; 
[.discoveredServicesVithlnfo uddGbject:diet]; 
return YES; 


* (BOOL) removeIttf^Service; (NSNetService *)service 
I 

NSDictionary "diet “ nil; 

NSEnumerator *e ” nil; 

NSMutableArray "delete “ nil ; 

// look for object with this service and nurk for delete 
delete ^[NSMutableArray array]; 
e & LdiscoveredServicesWithlnfo abjectEmuaeratorl; 
while (diet ■ [e nextObject]) 

if ([[diet objectForKey^"service"] 
isEqual:serviee]) 

[delete addObjcct:dlct]; 

// delete marked objects 

e = [delete objectEnumeratorJ; 

while (diet - [e nextObject]) 

LdiscoveredServicesWithlnfo remaveQbject:dictj ; 

return NO: 

I 

tend 

©implementation ARendezvousController 
(NSNetServiceDelegation) 

(vojd)netService;(NSNctService *)sender 
dldfkvt Publish;(NSDictionary "JerrorDict 

{ 

H publishing laikd 

.publishing = NO; 

NSLog (©"Publishing the service K£failed." t 
[sender name]): 

[.delegate discoveredServieesnidChange:selfJ; 

(void)netServiceWiliPubliflh:(NSNetService *)sender 

I 

ft does notlting for now, 

// implemented for your possible additions 

I 

(void)nctServiceDidStop;(NSNetService 1 3 sender 

// di>es nothing for now, 

// Implemented for your possible additions 

I 

- (void)netService:(NSNetService *)sender 
didNotRenolve; (NSDictionary "hr tor Diet 

H resolving filled 

NSLog (©"Resolving of address for service failed,", 
[sender name]): 

\ 

- (void)netServiceDidResol vcAddrcss: l NSNet. Service *)sender 

{ 

NSDaia 'address = nil; 

struct saekaddr.in 1 socketAddress 3 nil; 

NS St ring 'ipString *■ nil; 

int port, i: 

for (i = 0; i < [[sender addresses] count]: i++) 

I 

// father data about this published service 

address = [[sender addresses) obj ectAt index :i] r 
soeketAddress * (struct sockaddr_in “} 

[address bytes]; 
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ipString - [NSS tritig sttingWithFottRat: £"%s** 
inet_ntoa (socket Add re^is->sin_ad dr) ] : 
port * sockerAddiress->sin_port: 

// published localhost is ,i Rendezvous strangeness: 

// ignore that! 

if [[IpStrJng inEqual ToString :fi'' 127.0.0.1 ,r ]} 
continue; 

// notify delegate of change 

if [Ls$lf addlnfoService:sender name;[sender name] 
ip:ip3tring port:port|) 

[ delegate diacoveredServicesDidChangerself]: 


(voitUrietServiceWillResoive: [iWSNeLService Msetider 

( 

// does nothing ibr now, 

// implemented for your possible additions 

i 

fiend 

film piemeutation ARend ezvousControlle r 
{NSNetServiceBrowserBeXegarion) 

• (voidJnetSarviceBrowser:(NSNetServiceBrovser *) 
aNetS#rvictBrowser didFindService:(NSNetService *) 
allot Service moreComing: (BOOL) more Coming 

[ 

// add to (fkovered services and resolve it 
[aBletService setDelegate:self] ; 

[aNetService resolve]: 


- (void)netServiceB rows er : (HSNetServiceBrowser *) 
aNetS&rviceBrowser didRemoveService:(NSHetSarvica *) 
aNetSetvice morcComing:{BOOL]moreComing 

[ 

// remove and notify 

[self removelnfoServiceraNetServicel i 

l_de 1 egat e discovetedServiceeDidChange:self]: 


{void)netSeryiceB r owner DidStopSearch: 
(NStletServiceBrowsor ■JaNntServlceBrowser 

I 

// empty the arrays and notify delegate 

if (aNetServiceErowser = _servicefiruwser) 

t 


[_diecovcredServicesWithlnfo reraoveAllObjects]; 
Ldelcgate dlscoveredServicesDidChange;self]; 

1 

1 

- {void)natServiceBrovser;(NSNetServiceBrowser 1 ) 
aHetServiceBrowser didNotSearch;(NSDictionary MerrorDict 

1 

NSLog (@*Unab!e to search.**); 

I 

- (void)netServieeBrowserWillSearch;(NSNetServiceBrowser *) 
aRetServiceBrowser 

( 

// does nothing for now, 

// implemented for your possible additions 


- (void) net Service Browser; (NStletServiceBrowser ‘) 

aNetServiceBrowaer didFindDomain:(MSString *)domainString 
moreComing:[BOOL)moreComing 

! 

// does nothing tor now, 

// implemented for your possible additions 


- (void) netServiceBcowser: {NSNetServiceJirowser *) 

aNetServiceBrowser didRemoveDomain:(NSString •)domainString 
more Comin g:{BOO L)mo reComin g 

{ 

// does nothing tor now, 

// implemented tor your possible additions 

I 

fiend 
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MOVIE REVIEW 


By Andrew S. Doums 

Revolution OS 


The rise of the free software and open 
source movements 

Introduction 

Every so often a movie comes along that tells a techie tale in 
just the right way. Making the rounds right now at film festivals 
and on various movie channels is an independent film called 
Revolution OS. Produced and directed by J.T.S. Moore, 
Revolution OS tells the story of the rise of the Free Software and 
Open Source movements. Using a combination of news bites, 
camera shots of Silicon Valley, and occasional statistics illustrating 
the increasing adoption of Linux and popularity of Linux-related 
Initial Public Offerings, the movie intersperses such teasers with 
interviews with key players in these movements. 

The movie opens with Eric Raymond recounting an episode 
in which he encountered the Microsoft VP of Consumer Products 
at a conference, Eric concludes the encounter by telling the VP 
"I'm you're worst nightmare/ This opening exchange sets the 
tone for the movie: a growing movement that threateas the 
dominance of Microsoft. 

The talking head format used for these interviews works 
letter than you might expect, The main players are introduced 
with little fanfare. This allows you to focus on the message that 
each relays. We meet several of the players in the opening 
minutes: Eric Raymond, Linus Torn Ids, Bruce Perens, and 
Richard Stallman. 'lhe interviews show the passion as well as tile 
facts. The small amount of narration and voiceover provides 
some variety in the presentation, and in no way detracts from the 
message, ( here is no evidence of "Hollywood" in [his film. 

The tech talk is light. The most complex topic discussed is 
Lite distinction between the monolithic kernel architecture of 
Linux and the microkernel-based GNU HURD. If you read Cliff 
Stoll's The Cuckoo's Egg, the superficial treatment of potentially 
complex topics is similar though engaging. This makes the 
movie accessible to a broader audience. 

For example, Bruce Perens, the author of Lhe Open Source 
Definition, discusses open source as a way for developers to 
collaborate on projects without restrictive intellectual property 
laws and contracts gening in Lhe way. Those developers 
sacrifice intellectual property rights in an effort to increase the 


number of users of the software. This could easily have gotten 
lagged down in legal terminology, but Bruce makes the topic 
easily accessible. 

We also find out that the connections between Lhe 
philosopher Stallman, the engineer Torvalds, and the companies 
lhat aim to bring these products to market are based not on a 
bandwagon mentality but on real experience with the 
underlying products. Michael Tiemann of Cygnus Software and 
Larry Augustin of VA Linux Systems, who serve as the film's 
primary entrepreneurs, were both programmers who 
contributed to the GNU software code base earlier in their 
careers. No doubt this enhanced their ability to make otherwise 
free Lools a commercial success. 

Another indication of the symbiosis between companies and 
philosophers is Netscape’s decision to release its browser source 
code (the Mozilla project ) as open source based on the principles 
espoused in Eric Raymond’s The Cathedral and the Bazaar . 
Fearing a Microsoft monopoly and perversion of HTML and 
HTTP, Netscape became die first commercial vendor to offer its 
source code as a product. 

free vs, Open Source 

Tlie movie goes to great lengths to balance the discussion 
between the Free Software Movement and Open Source. 
Although Linux and Open Source receive the lion's share of 
media attention, we find out that Richard Stallman and the Free 
Software Foundation predate Open Source by ten years or so. 

Free software and open source are not synonymous. Free 
software is more of a political stance than an economic one: 
"free" refers not to price but to philosophy, f ree software can lie 
used and modified without restriction. In the proprietary, single 
vendor or non-free software world we know this concept as 
piracy, except where very liberal licenses apply. Free software 
began as Richard Stallman's personal crusade about twenty years 
ago. Interviews with Richard in the movie clearly bring out the 
zeal and passion in the man. What started as a configurable Lex! 
editor (Emacs) in the 1980s evolved along several non¬ 
contiguous paths, including the Free Software Foundation's 
GNU project and the Open Source movement where Linux and 
Apache remain the most obvious examples of successful 
projects into an essential dement of our technology 


Andrew writes embedded system software in New Orleans, LA. You can reach him at andrew@downs.ws. 
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infrastructure. Some businesses base their products on code 
originating from free software. 

Freedom to modify is a pillar of this philosophy. The 
responsibility accompanying LhaL freedom comes in rhe form of 
the GNU Public License (GPL). The GPL stales that distributing 
a product ihai uses free software within its core or periphery 
(derivatives of the GPL differ) requires the distributor or vendor 
to also distribute or make available the product source axle so 
that others may enjoy the same freedom to use and modify. 

Making monky 

One important question with regard to both free software 
and open source software (which by definition is free-of-charge) 
is “How do you make money?" At firsi blush it may appear 
impossible. After all, 1 or any programmer or hacker wiLh a 
compiler can download, modify, and build rhe finished product. 
Then I can simply give it to my friends and coworkers, right? 

Yes, you can if the license permits it. But your next question 
might t>c "How do f configure it for my system?" Or “Why did it 
not install properly on my system?" If you have time and desire 
you may be able to determine the answers on your own. But 
businesses typically do not plan for, pay for, or sometimes allow 
this experimentation to occur on their dime. They prefer to call 
or email someone else for support. 

And ihere lies the answer to the moneymaking question. 
The rise in outsourcing encourages firms that specialize in 
support (including packaging, installation, configuration, and 
usage issues) of open source and free software products. 
Businesses can Lhun expense support costs by purchasing a 
packaged GNU/Linux product from a vendor such as RedHat, 
Caldera, SuSE, or VA Linux and receive ongoing support from 
outside the company. This reduces or eliminates the need for in- 
house expertise, though pockets of knowledge within the 
company will remain and likely grow, 

Microsoft 

Microsoft's role in the movie is camion fodder for several 
anecdotal episodes discussing encounters between free software 
and open source luminaries and Microsoft managers and the 
company-at-large. One of the most memorable is Bill Gates’ 
1976 letter to the Homebrew Computer Club, in which he 
verbally dubs those developers who used Microsoft's BASIC 
compiler without paying for it. In contrast, the Windows Refund 
Day protest in 1999 provided less drama, since Microsoft 
provided drinks rather lhan water cannons when the protestors 
showed up at their building. But die movie is not a Microsoft 
bashfest. Rather, ti illustrates the reasons behind the rise of open 
source and free software. These people changed the world in 
response to the proprietary software philosophy, of which 
Microsoft is [he most visible proponent. 

Apple 

So where is the Apple and Mac OS connection in all this? 
The movie discusses free software (the GNU tools) and open 


source (Berkeley Unix) products that are familiar territory to Mac 
OS developers with the rise of OS X. The GNU development 
ttx)ls lie at the center of Project Builder, the development 
environment that ships with OS X. Berkeley Unix, itself an 
attempt to bring freedom to the category of operating systems by 
competing with AT&T's proprietary Unix, lias over die years 
given rise to offshoots dial use open source and collaboration as 
their development philosophy, FreeBSD is one of those 
offshoots and sits near the core of OS X. (The Mach microkernel 
resides underneath. Mach is another open source project that 
receives little air time in the movie but broke new ground in 
kernel development.) 

At the other end of the Mac OS spectrum are technologies 
such as Aqua and QuickTime that are unlikely to become open 
source candidates since they are key to differentiating Mac OS 
from competing operating systems. 

In the middle lie extensions to the kernel and BSD 
subsystems, including Directory Services and Rendezvous. These 
remain open source projects maintained by Apple and interested 
developers outside the company. 

Suggested Reading 

I enjoyed this movie, but it may leave some technophiles 
longing for more. Its treatment of technical issues is light. If you 
find the movie intriguing or simply want to learn more about the 
people, ideas, and products involved, here are several books 
you should consider reading: 

* The Cathedral and the Bazaar: Musings on Linux and Open 

Source by an Accidental Revolutionary , by Eric S. Raymond, 
1999, 2001, O'Reilly and Associates, Inc. The essays in this 
book capture the essence of the open source philosophy and 
attempt to quantify' and explain die "why" behind the "what". 

* Free as in Freedom; Richard Stallman's Crusade for Free 

Software , by Sam Williams, 2002. O'Reilly and Associates, 
Inc. Ibis book presents Richard Stallman's free software 
philosophy and history through recaps of interviews with die 
man himself and other sources. 

* lust for Fun: The Story of an Accidental Revolutionary, by 
Linus Torvalds and David Diamond, 2001. HarperCollins. 
Half-written by Linus Torvalds, with the balance consisting of 
interview recaps, Lhis lxx>k provides insight into Linus' 
character and views on life, Linux, and the pursuit of family. 

* Open Sonnes: Voices from the Open Source Revolution , 

edited by Cluis DiBona, Sam Ockman, and Mark Stone, 1999- 
O'Reilly and Associates, Inc. This contains essays by 
Stallman, Raymond, Torvalds, Kerens, Tiemann and others. 

* Rebel Code: The Inside SLorv of Linux and die Open Source 

Revolution , by Glyn Moody, 2001. Perseus Publishing. An 
account of the rise of Linux from a spare-time college project 
to its dominance Loday. 

* Also, check out the Revolution OS web site at 
hrtp://www. revolution-ns.com/. 
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By Jay Martin Anderson 


From Algorithm to Animation: the Sequel 


Making QuickTime movies which 
illustrate abstract processes 


THE ORIGINAL 

In the Ncveml)er 1993 issue of MacTech (volume 9, number 
11), I descried how 1 made a QuickTime movie of an algorithm 
from computational mathematics. In the intervening ten years, 
QuickTime has grown anti matured, the Mac OS has crossed the 
divide between Classic and OS X, and several generations of 
IDEs have come and gone. 

My interest in making QuickTime movies to illustrate 
algorithms from computer science and mathematics has not. 
Consequently, I wish to present an update of the technique used 
to make animations of algorithms, and apply it to a theorem 
from beginning calculus which my colleagues challenged me to 
illustrate this year. 

THE PROBLEM 

The Department of Mathematics at Franklin and Marshall 
College includes both mathematics and computer science and 
frequently enjoys sharing problems in one area with the other 
In the spring of 2003, my mathematician colleagues challenged 
me to construct a way to depict the Mean Value theorem (M\ T) 
which states that, for a suitably “nice* function fix) on a range a 
< x < h, somewhere (some x = c, a < c < h) the slope of the 
function, f(c) is equal to the “rise over run" of the function, 
(f(h)-jfa))/(h-a), 

I chose to take a particular function f(x) - on the range 
-1 <x< /, trace along the function showing a line tangent to the 
curve at each point, and slop when the tangent line had the 
same slope as the “rise over run," which is 1. 

THE PARADIGM 

At F&M we have developed a paradigm for coastructing 
algorithm animations. We divide the moviemaking application 
into three parts; the model, the view, and the controller. 


The model contains the algorithm to be visualized. In 
this example, it is the function and its derivative. The state 
of the model is the value of .v t along with the value of f(x) 
and f*(x). 

The view contains the graphical elements necessary to 
illustrate the model. It is in the view that a single picture of 
a single sLale of the model is developed. In our work 
beginning in 2003, the view is developed with OpenGL. In 
the view we will draw the graph of the function, the tangent 
line at every value of .v, the line which represents the “rise 
over run,* and any tangent line with the same slope as “rise 
over run," 

The controller does all the initialization and cleanup 
necessary for the moviemaking application. In particular, it does 
all the work necessary to pass individual views to QuickTime for 
the formation of a movie. Most importantly, the controller 
contains the timing, which signals the model to change its state 
and the view to generate a new picture. The controller will 
continue to ask the model to change its state until the value of x 
has spanned the entire range of interest. 

Many movies are divided into “acts" and “scenes," much like 
a real theater piece. This provides a simple way to modularize 
the model and the view, and is particularly useful if the animated 
view of the model is more complex than simply moving an 
object along a path. For this simple example, acts and scenes are 
not necessary. 

Our movies are also annotated. A view of a state of the 
model is also accompanied by a few sentences of text which 
explain what the view shows. The resulting QuickTime movie 
lias one video track, and one text track for each (raiLura!) 
language necessary. The natural language feature of QuickTime 
makes it particularly easy to construct movies in English, 
German, Italian, etc. The text annotation in this movie gives 
numerical values for x and fix). 

Beginning in 2003, our development platform for 
algorithm animation is Apple's Developer ‘fools, including 
Project Builder and Interface Builder. The application is 
developed in Objectlve-C, using Cocoa classes. The model is 


Jay Martin Anderson is the Richard S. and Ann B. Barshinger Professor of Computer Science ai Franklin and Marshall College in Lancaster, Pennsylvania. 
Once a physical chemist, he has been teaching computer science since 1978 and making QuickTime movies since 1992. 11 is interests include many aspects 
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a subclass oF NSGbject the view is a subclass of 
NSOpenGLView; and the controller is also a subclass of 
NSObjsct Since the movie, and not the application which 
creates it, is the object of this exercise, the graphical user 
interface is kept as simple as possible, often including only a 
button “Make Movie” and perl taps some widgets to select 
among choices for the movie. 

The connection between die strictly object-oriented 
Ohjective-C and Cocoa classes* and the older QuickTime API 
is not always elegant. Nonetheless, it is that connection which 
is perhaps the most significant contribution of this article. 
Almost every time the controller has to move information 
between the model or the view and QuickTime, some 
conversion is necessary. 

Using Interface Builder 

We begin with Project Builder and construct a new project, 
a Cocoa application. Interface Builder allows us easily to 
construct a window and view of appropriate size, place 
whatever GUI w r idgets we need in the window, construct the 
model and controller objects, and generate some source code for 
die modd-view-coniroiler system. 

Launch Interface Builder by double-clicking the 
MainMenu.nrb icon, which is found inside the Resources folder of 
die Files pane of the project. Make the window an appropriate 
size, and drag a Custom View onto the window. Make Lite 
Custom View lie an appropriate size as well. Create a subclass 
of NSOpenGLView, such as MyOpenGLView, and make the 
Custom View be an instance of MyOpenGLView. 

Drop whatever widgets you need into the window. In this 
example, we use only a button, labeled Make Movie 

Create a subclass of NSObject called MyControHer and a 
subclass of NSObject called MyModel Within MyCorrtroller, create 
an Action method, for example, createMovie Also within 
MyControHer create Outlets, which are instances of the classes 
MyModel anti MyOpenGLView, respectively. Likewise, in the class 
MyOpenGLView, create an Outlet, which is an instance of die 
class MyModel 

Make instances of these classes, and generate code for these 
classes. 

Build connections as follows: from any widgets, such as the 
Make Movie button to the instance of MyControHer, with the target 
of the createMovie method; from the instance ol MyControHer to 
the instance of MyModel: from the instance of MyControHer to 
MyOpenGLView; and finally from the instance of MyOpenGLView 
to the instance of MyModel The connecdon from the button to 
die method means that the button sends the createMovie 
message to the controller. The connection from die controller to 
the model means that the controller can send messages (usually 
inquiries) to the model* and likewise to the view, 'The 
connection from the view to the model means dial Lhe view can 
send messages (again, usually inquiries) to the model, 
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Figure L Using interface Builder, The window contains the 
view , a subclass u/ NSOpenGLVIew and one button , The view is 
connected to the class MyMocte/. so that the view may inquire 
the state of the model 


This completes the work w ith interface builder: save the nib 
and continue with Project Builder. 

The Code 

The work of managing QuickTime is done with the 
createMovie method of the controller object. This also includes 
code to provide an interface, albeit awkward, between the 
Gbjcctive-C classes of Cocoa and the “legacy* code of 
QuickTime. Three points hear special mention. 

First, OpenGL draws into a context , which is described by 
a pixel format. QuickTime accepts images from a pixMap, 
which is part of the GWorid data structure. The function 
CopyNSBitmapImageRepToGWorld accomplishes the task of 
copying pixels from the first to the second environment. It is 
based on the assumption of 32 -bit pixels in each structure. 
Curiously, the copying of pixels requires an MSBitmapImageRep. 
which is Tour bytes wider than the context 

Second, QuickTime constructs a movie file using an 
FSSpec The FSSpec must be derived from a path or file name 
in the “classic” Macintosh formal, and it must appear as a Pascal 
string. The function QTUtils ConvertCToPascalString serves to 
convert a C-string to a Pascal string, 

Finally, the image drawn by OpenGL is inverted when it is 
copied to QuickTime. Given that the QuickTime movie is the 
object of this exercise* it seems simplest to construct the OpenGL 
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drawings upside-down, and let the pixel copying ro QuickTime 
inveri them to the proper orientation. 

Tiie code for the class My Controller, as well as for portions 
of the classes MyModel and MyOpenGLView, along with all header 
files, can be found on the website 

http^/eDisk.fandm.edu/-jay.anderson/mactech/ f exampte.html 


Listing 2: MyOpenGLVicw.m 


MyOpcnCiLVicw 

Ihf method drawKect frum ihe dm MyOpoiGLView; the remainder of the class and 
tilt header file MyQpenGLVtew.il art found on the webaile, This method Is invoked 
when the display message is sent to the view. It draws each frame of the movie. 


6 itn p 1 etnent at i on HyOp n n GLV i ew 
(void) d rawRect; fNSRcct) reel 
I 

float x, y. slope: 
short tnatch: 


The model is Lhe simplest unit, in this example. The 
methods f and ff serve to calculate the function and its 
derivative. The method changeState advances a point along 
the curve by equal increments in the x-direction, and 
computes the corresponding value of the function and its 
derivative. The method changeState also looks for matches 
between the slope of the curve and the “rise over run,” and 
records the matches. 


Listing I; My Model, m 


My Model 

A portion of the class MyModd, which encapsulates the algoritlmi to be illustrated and 
Us data structures. Shown here arc the method changeState. and the methods that 
evaluate the function and its derivative The remainder of the class, and Lhe header file 
MyModeLh arc found on the website. 


^implementation MyMode.l 

(void)changeState:tint)frNo 
I 

if (ft.No = D) 

[ 

// beginning frame is blank, with only an annotation 
strepy(annotation, "MEAN VALUE THEOREM, Compare 
rise/run tp aiope of graph."): 

1 

el se 
( 

// as frame number goes from U to 200. x goes from 1.0 to 1.0 in 200 steps 
x = -i.O + frNo/lOO.Os 
y “■ [self f:xl : 
slope “ [self ff;x]: 

sprintf(annotation, M x = %5.2f, y = V5.2f. slope = 
S5.2f" . x t y, slope); 

if (fabs(slope - rot) < 0,01) 

I 

// slope matches rise/run; record this position, append extra annotation 
match = I: 

xMatch[nMatches++3 = x: 

strcat(annotation, n \rSlQpe matches rise/run: mean 
value theorem!"): 
i 

else 

match - 0: 

1 

I 

(float)f: (float)z 
l return z'z*z: ] 

■ (float)ffl(float)z 
f return l*z*z; ] 

(®end 


The view is responsible for drawing lhe curve, the "rise over 
run" line, a point and tangent line which moves along the curve 
as the state of the model changes, and any matches between the 
slope of the curve and lhe rise-over-run line. These are simple 
OpenGL primitives: point, line and line-strip. Colors, the point 
size and the line width are chosen for viewing ease. 


glClear (GL_C0L0R_ BUFFER BIT); // dear the screen 

x = model->x: 

y = model>y; 

slope = model >slope; 

match - model >match: 

r Draw the components of the frame: the graph of the (unction, the rtee/run line, 
the point at (x, y), and the slope of lhe graph at that point. 

7 

(self drawGraph] * 

[self drsvrRR] i 
[self drawPoint:x:y]: 

(self drawSlope:x:y:siopej: 

P Draw a tangent line at each place where die slope of die function matches lhe 
rise/run line. 

7 

if (model->nMatchert > 0) 

I 

int i: 

for (1 = 0; i ( model - ^Matches: i++) 

[self drawMatchri]: 

ff show it! 

glFlushC): 

1 

Send 


The lexi annotations are developed within the model, and 
left in a string. In die controller, this string is copied to the text 
handler, just as the image is copied to an image compressor. 
Color, Font, and size of text can be chosen when The text handier 
is constructed. 


Lights! CAMERA! ACTION! 

The controller runs a simple loop to construct successive 
frames of the movie, In particular, the controller sends the 
changeState message to the model, and then the display 
message to the view. This image is ihcn copied to QuickTime 
and compressed. In addition, the controller sends a getText 
message io the model to acquire the annotation to be placed 
into the text track. 


Results 

The model-view-controller paradigm lias been implemented 
for making QuickTime movies that illustrate algorithms in Java 
and in Cocoa/Objectlve-C The Cocoa/ Object! ve-C 
implementation allows the use of OpenGL with QuickTime in a 
workable, if awkward, marriage of Objective-C classes with 
legacy" QuickTime APIs. This opens up abstract moviemaking 
to the standard of OpenGL, including three-dimensional 
graphics. The Java implementation, which is not described here, 
does not require the awkward connection between software 
components, but does not provide easy access to OpenGL. 
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Figure 2 One frame of the Mean Value Theorem movie. The 
test point has moved from x~ -LOO tax = -032, and bos found 
one spot where the slope of the curve matches the rise/nut line. 
The text track is shown in white on blue beneath the video track. 

Besides die sample movie described here, our work in 2003 
and beyond includes constructing animations of algorithms from 
computational geometry, such as t he triangulation of a polygon, 
constructing and searching in kd-trees and range trees, and 
more. Our recent work includes animations of algorithms for 
computing the convex hull, for the intersection of many line 
segments and for recognizing the polygon in which a point lies. 
Sample movies are posted on our web site (begin at 
http://eOisk.fandm.edu/-jay.anderson) as they become available, 
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REVIEW: FUGU 


By Brian Shin 

Secure File Transfers With Fugu 


Review and how to for Fugu 


YoifR Last Bin-? 

Anybody who speaks Japanese would recognize Fugu as the 
diodon hobcanthus, the poisonous blowfish. This delicacy, 
popular in Japan anil rhe Philippines, contains a poison called 
tetrodotoxin, 1200 limes deadlier than cyanide. Of course this 
has nothing to do with our Fugu, a wonderful graphical interface 
to secure file transfer (SHIP) and seal re copy (SCP) Fugu’s 
home page is http://rsug.itd T umich-edu/software/fugu/. Fugu is 
freeware and can be downloaded from 
hTtp://rsugjtd,umich.edij/software/fugu/downIoad.html, 

Prying Eyes 

Our non-toxic Fugu allows us to transfer files with the 
same ease of use of Fetch but retains the security of 
command line SFTF and SCP. Regular FTP sends the user 
name and password in clear text- This means anybody who 
can sniff your Ethernet packets, can get your user name and 
password. Using Etherpeek™ and a shareware hex editor, 1 
was able to sniff out my own FTP user and password in just 
a few minutes; 

User; 

\*USE.ll jlpi 
car«i. 5C 01 55 
53 45 52 20 6A 6 
C 70 69 63 61 72 
64 00, 

Password: 
j- PASS ent 
^.rpri* 5D OK 50 
41 53 53 20 65 
6E 74 65 72 70 7 
2 69 73- e-,,,, 

As you can see, the hex editor allows me to read the user 
name “jlpiord" and the password "enteq^rise". With FTP this 
easy to hack, you can see why it is important to use SKIP and 
SCR Running the same test using Fugu rendered the encrypted 
user and password completely inaccessible and protected from 
prying eyes. 


Keep the Door Closed 

Another benefit from using Fugu is not having to use port 
21 (FTP), one of the most common pons used for hacking. Port 
21 is subject to constant attack from hackers on the internet, 
Fugu uses port 22 instead of pon 21, This allows you to turn ofF 
your FTP servers and close port 21- A search on Google for FTP 
hacks will leave you stunned as to what hackers are doing with 
FTP and pon 21. 

MAKING THE CONNECTION 

Servers you connect to need to have SSI ID running. In OS 
X, getting SSIII) mnning is as easy as going into System 
Preferences, select the Share pane, select the services tab, and 
turning on Remote Login. For OS X server, yon can configure this 
in the server admin utility. If you are on a different server, go to 
http://www.openssh.org/ for die installer. 

Making the connection with Fugu is as easy as it gets: 


©0© 


t © 
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L 
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J 
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0 f Add W Fdvor lici 

) 






Figure 1 . Connecting to a sewer with fugu is as simple as 
entering the IF address and user name. 


Brian Shin once worked [br us ;ii MacTech, but moved on to run his own company, providing accounting software solutions to Mac run businesses. 
Between SCUBA dives, he also provides consulting and other programming services. You can reach him at brian@prometheia.com. 
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THE BEST SELLING INTERNET COMPONENT 
SUITE FOR WINDOWS, JAVA, LINUX, 
SOLARIS, AND MORE... 




IP*Works! 

The Only Truly Comprehensive 
Internet Toolkit 


-* d* 



fP+Wnkd 


* More Than 30 Components Cover 
All Major Internet Protocols 

- Follows Exact RFC Specifications 

* Market-Tested For Over 7 Years 

- In Use By Almost AM Fortune 500s 


- Royalty “Free Pricing 


IP*Works! for Mac OS X (10.0/10.1/10.2) gives you 
access to a host of new capabilities that will connect 
your applications to the Internet with unprecendent- 
ed easy of use t power y and flexibility! You will be 
able to easily and quickly: 

- program the weh: HTTP, WebForm, WebUpload 

- call web services: SOAP XMLp 

- transfer files: FTP, TFTP 

- send email: SMTP, File Mailer, HTML Mailer 

- receive email: POP IMAP 

- read/post news: NNTP 

- encode/decode: MIME, Net Code 

- access directories: LDAP 

- manage networks: SNMP, Whois, Ping, TraceRoate 

- build clients and servers: IP Port, IPDaemon 

- build packet applications: UDPPort, Multicast 

- remote access: Telnet , Rexec, Rshell, RCP 


Once connected to the server, Fugu behaves like just about 
any other FTP client. The only exception is folder copying. 
According to the documentation, SFTP does not support folder 
copying. Fugu circumvents this by turning the folder copy 
attempt from SFTP into a SCP. Fugu will also ask you to re- 
authenticate the copy. This works fine but it w r iil not retain the 
directory information of the copy. For example, you need to 
copy the directory ../stuff to your computer at ../Desktop/stuff. 
The contents of../stuff on the remote computer will all be 
dumped to /Desktop. 
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...and a whole lot more! - download your free trial 
today from www. nsoftware. com! 


’•n.fouu' 

U vjJLn 


2 < lijj 

ili.kR 


IP* Works! for 
MacOS X is currently 
available as a C/C+ + 
Library (OS X Framework). 
Objective-C Classes for 
Cocoa and ReatBasic 
if plugins coming soon at 
www.nsoftware.com 


STAY TUNEDl 



software 

www. nsoftware.co m 


THE #1 PROVIDER OF PROFESSIONAL 
INTERNET COMPONENTS 





























reliable - high quality - competitive rates - efficient - award winning - qa services - reputable 


high quality - competitive rates - 16 years experience - award winning 


Full Spectrum Software 

Development & Testing 

Device Drivers 
Porting Plug-ins 

TCP/IP 

Carbon / OSX 

Cross Platform Development 


One Bridge Street 
Newton, MA 02458 




Easily create help systems for your software 
applications & web sites from a single source. 

Save time with the integrated Workshop, TOC Builder, 
HTML Editor & Page Templates to quickly generate 
Apple Help, Web-based Help, UniHefp, PDF & more. 


SNEAK PREVIEW 

www.ebutterfly.com 


n 


Add I Ht 


Edit Page 


Add Topfc 


Projttl Fites 


Project: Stimulus Help 


Edit Topic Preview 


Help Table of Contents 


0 flteformJTihtml Q Introduction 

^ images Q System Requirements 

U dntr eduction. Hi ml t How to Use Stimulus 

] license.hlmt Q Supported Formats 

’J^rtquIreTiieiTts.html T ^5 Audio 

Q Bi5s and Treble 


Workshop 

► Q 

^ 0 To Do Items 

► & Testing 

► $ Feature Reqi 

► ^ Bug Reports 

► [c?J Code Snippt 


Connect with SFTP 

Under the SFTP menu you can get info on files and folders 
on your system and the remote computer, if you open the 
console window, you can see command line equivalents to 
your graphical work and enter direct commands. Notice of all 
the keyboard commands in the SFTP menu. They make 
navigation between remote and local directories and panes 
quick and painless. 


Connect with SCP 

SCP transfers work differently than SFTP. Rather Lhan 
moving files back and forth between computers, SCP transfers 1 
file or a directory at a time. 

Connections are similar to SFTP but you need the name of 
the file you want to send or get before-hand. 


© e 



Secure Copy File 


Item to Copy: 

i -: 

/Users/bnanshin/Desktop/Defauitpdf 

Recent Copies ▼ 1 ( Choose.. ^ 


Copy Type: 


Remote Host: 
User Name 
Copy Fite to Path 



© Upload Item to Remote Host 
C Download Item from Remote Host 

192.168.1.109 9 

cyborg Port: 

I home/ cyborg/Docomentsj 

Cancel ^ Secure Copy ^ 


Figure 4, Enter file, upload/download, userid and path, 

After you enter this information, a new window will appear 
to enter the password, if the upload/download transfers 
correctly Fugu will give you ihe following message; 



/Users/brian shin/Desktop / Default.pdf 
copied successfully to 192.168.1.109 


New Secure Copy ( Done 


Figure 5* Copy to server successful with option 
for more transfers. 
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NO SAFE 1IARBOR FOR YOUR SHIP? 

Now, what happens if you need to connect to a FTP server 
that does not use SFTP or SCP? You can create a SS11 tunnel to 
protect yourself. From the SSH menu, select new T SSH tunnel or 
press comma nd-T. 


_ 

Remote Host: 
Remote Port: 

Tunnel Host: 
Username 


Create SSH Tunnel 


•—a 

, I ' w ) local Port: 

Pon: 0 T 

Cancel ( Starr Tunnel ^ 


Figure 6 . New SSH Tunnel u/indow. 


Enter the remote host and tunnel host IP numbers. The 
remote port is usually port 21 and the local port can l>e any port 
greater than 1024. Enter your user name for SMI; the port is 
optional. You w ill he prompted for your password after you hit 
the start tunnel button. 


Now' that your tunnel is up, your FTP connection will l>e 
redirected securely through your tunnel host to the FTP server. 

Must have program 

Fugu is the kind of application that makes OS X so 
wonderful, h provides a graphical front end to powerful Unix 
command line tools. The console window gives the user the 
best of both worlds by allowing users to see what the graphical 
front is doing and giving the users an opportunity to type in 
your own commands. 

Keyboard lovers will be pleased that every feature you can 
access with your mouse has a keyboard equivalent. The 
kcylx>ard shortcuts are listed with every pull down menu. A 
comprehensive list of them is available from the help menu. 

Installation of Fugu simple, and problem free. The user 
manual explains features in detail, and provides screen shors of 
how to use each feature. The manual also has extensive version 
history and a decent FAQ section. 

The source code to Fugu is publicly available and there are 
German. Dutch, and Japanese localizations- French, Spanish, 
and Russian are on the way. With publicly available source code, 
localizations, Fort Knox security, great ease of use, a well-written 
manual, and top it off with a total cost of free makes Fugu THE 
essential tool for sharing files over the internet that no user 
should go without. 



It's 3am on Sunday morning , 


Ifi THE SERVER STILL RUNNING? 


The simple reliability 
solution for Mac OS 9 and X 


End the 
worry with 


+ System-level Crash Detection * 

patented hardware-software integration W 

* Automatic Crash Recovery 

system restart or power cycle, as needed 

+ Monitor Custom Applications 

software developer's kit and plug-ins included 

* Scheduled Restarts 

cures memory leaks and fragmentation 

+ Restart after Power Failure 

even if shut down by your UPS 

* Comprehensive Error Logging 

to help you track down problems 

+ Simple Installation 

just plug in AC cord and USB cable 


For all these features plus six power 
outlets controllable by phone tones, 
schedules and scripts, consider 
our PowerKey Pro 650 Admin. 


www.sophisticated.com 

/ S( )PI IISTICATF.DCl RCUITS 


Copyrigtil ©MG2 Sophistic eted Circuits, tnc. (OtMffl and PowarKeyaro roistered trademarks 
of Sophisticated Cif nulls, Int. Mac OS <s .1 registered Irademaik of Apple Computer. Inc. 



















By Michael R. Harvey, Reviews Columnist 


TiGlide and iGlide 


Eliminate the squeak, level the screen 


Introduction 

Every now and again, one company will come up wiLh axils 
dial are so .simple, yet so necessaiy, you wonder why seventeen 
other people didnl iliink of ii before. RadTech is one such outfit, 
'lhese guys have come up with several great, yd simple, tools 
designed to protect your favorite mobile computing platform. "Tliis 
time out, well l>c kx)king at their tools designed to level the screens 
on PowerBooks and iBooks, as well as smooth hinge operation. 

IGliDF. 

'rhe kit for smoothing the hinge operation on iBooks conies 
with a small hex wrench, a vial of metal conditioner, anti 
detailed, yet easy to follow directions. Hollow the instructions, 
and you will shortly find the hinge on your iBook operates 
smoother than ever. The iBook we tested was very tight, and 
squeaked something fierce before applying RadTechs changes. 
Afterwards, operation was smooth and silent. Be careful to 
follow the directions precisely, though. We were not that 
diligent, and managed to crack the case on our iBook around 
one of the hex screws on the underside of the laptop. 

TiGlide 

Like the iGlide, the TiGlide kit comes with all mentioned 
above. It also comes with a t<x>l to help loosen the hinge 
bushings in order to smooth, operation, as well as shims and a 
wood pry tool to level the screen. Again, follow the directions 




carefully in order to prevent damaging your computer. We 
performed ihe adjustments on several Titanium PowerBooks. All 
saw vast improvement in hinge operation. We were able to level 
the screen as well, but it would not really hold for reasons well 
get into next. 

What's the deal? 

What is it that makes these kits work, and why doesn't rhe 
chassis alignment on the TiBooks hold very well? First the main 
part of the kit, the one thing that makes it all work well, is the 
metal conditioner. It is a synthetic hydrocarbon that acts as a 
lubricant, smoothing the hinge operation. It works better than 
any other oil or grease you could use, and it is safe for the 
materials that make up the laptop. Next is the problem with 
keeping the Titanium PowerBook G4s screen level with die 
chassis. While the process works just fine, there is nothing to 
help it stay that way included in the kit. HadTerh does offer a 
product they call Wikleepz, display cushions designed to keep 
die display level as well as keep the screen from touching the 
keyboard when closed. It would be nice if they were included in 
the TiGlide kit, instead of as a separate purchase. 

Conclusion 

RadTech has quite a line of useful pnxjucLs designed to extend 
the life of your PowerBook and iBook computers. The TiGlide ami 
iGlide are two such, and they do their job almost flawlessly. They 
are well worth the price, $10 for the iGlide kit, and either 1$12.95 
or $15 for the TiGlide (without or widi a T-8 Torx driver, 
respectively). They are more than worth the small cost. 

www.radtech.us 
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“Without a doubt, the Premiere Resource Editor 
for the Mac OS ... A wealth of time-saving tools.” 

- MacUser Magazine Eddy Awards 

14 A distinct improvement over Apples Res Edit / 7 

- MacTech Magazine ^^B 

“Every Mac OS developer should own a copy of Re sorcerer / 7 ^^B 

- Leonard Rosenthal, Aladdin Systems 

“Without Re sorcerer, our localization efforts would look like a. ^ 

Tower of BabeL Don't do product without it /” 

— Greg Galanos, CEO and President, Metrowerks 

“Resorcerer's data template system is amazing.” 

-Bill Goodman, author of Smaller Installer and Compact Pro 

“Resorcerer Racks! Buy it, you will NOT regret it.” 

- Joe Zobkiw, author of A Fragment of Your Imagination 

‘Re sorcerer will pay for itself many times over in saved time and effort 

- MacUser review 

"The template that disassembles * PICT*s is awesome!“ A 

- Bill Steinberg, author ofPyro! and PBTools Jjjm 

“Resorcerer proved indispensible in its own creation /” jBBBb 

- Doug McKenna, author of Resorcerer 




Version 2.0 



• Very fast, HF3 browser for viewing file tree of all volumes 

• Extensibility for new Resorcerer Apprentices (CFM phig-ii 

• New AppleScript Dictionary (‘aeteO Apprentice Editor 
■ MacOS 8 Appearance Manager-savvy Control Editor 

• FowerPlan t tex t traits and menu command support 


* Extensibility for new Resorcerer Apprentices (CFM plug-ins 

* New AppleScript Dictionary (‘aeteO Apprentice Editor 
■ MacOS 8 Appearance Manager-sawy Control Editor 

* FowerPlan t tex t traits and menu command support 

* Complete AIFF sound file disassembly template 

* Big-, little-, and even mixed-endian template parsing 

* Auto-backup during file saves; folder attribute editing 

* Ships with PowerPC native, fat, and G8K versions 



Requires System 7.0 or p'eater, 
L5MB RAM, CD-ROM 


Standard price: $256 (decimal ) 
Website price: $128 - $256 
(Educational, quantity, or 
other discounts available) 


Fully supported; it's easier, faster, and more productive than ResEdit 
Safer memory-based, not disk-file-based, design and operation 
AU file information and common commands in one easy-to-use window 
Compares resource files, and even edits your data forks as well 
Visible, accumulating, editable scrap 

Searches and opens/marks/selects resources by text content 
Makes global resource ID or type changes easily and safely 
Builds resource files from simple Rez-like scripts 
Most editors DeRez directly to the clipboard 

All graphic editors support screen-copying or partial screen-copying 
Hot-linking Value Converter for editing 32 bits in a dozen formats 
Its own 32-bit last Mgr can open and edit very large data structures 
Templates can pre- and post-process any arbitrary data structure 
Includes nearly 200 templates for common system resources 
TMPLs for Installer, MacApp, QT, Balloons, AppleEvent, GX, etc. 

Full integrated support for editing color dialogs and menus 
Try out balloons, ‘ictb’s, lists and popups, even create C source code 
Integrated single-window Hex/Code Editor, with patching, searching 
Editors for cursors, versions, pictures, bundles, and lots more 
Rel ied on by thousands of Macintosh developers around the world 


Includes: Electronic documentation 
60-day Money-Back Guarantee 
Domestic standard shipping 


Payment; Check, PO's, or Visa/MC 
Taxes: Colorado customers only 


Extras (call, fax, or email us): 
COD, FedEx, UPS Blue/Red, 
International Shipping 


MaTHEMjESTHETTCS, INC. 

PO Box 298 

Boulder, CO 80306-0298 USA 
Phone: (303) 440-0707 
Fax; (303) 440-0504 
resorcerer@m athe m ae sth e tics. com 


Try out balloons, ‘ictb’s, lists and popup: 
Integrated single-window Hex/Code Edi 


lb order by credit card, or to get the latest news, hug fixes, updates, and apprentices, visit our website^. 


www.mathemaesthetics.com 













TIMBUKTU PRO 
6.0.3 FOR OS X 
REVIEWED 


By Chris Kilhourn 

From Here to Timbuktu 


A venerable tool is updated for OS X 


Ensconced In Its Evolutionary Niche 

In biology, a holotype is the original specimen used to 
describe a species, In the taxonomy of Macintosh applications, 
Timbuktu Pro, published by Netopia, Inc,, is ihc holotype for 
remote desktop screen sharing and file exchange software, 

Timbuktu Pro's original copyright dates to 1987, the era of 
the MucSH and Mad I, and network administrators and remote 
help desks die world over have been singing its praises ever 
since, Timbuktu Pro provides a remote desktop screen In a 
window with the ability to either view' or control it, a file 
exchange function, a text chat method and, if you and a remote 
machine have microphones, an audio intercom feature. 

With the ability to remotely control other computers and 
exchange files with them, Timbuktu Pro can lx. * 1 * * * * * a huge time 
saver in solving problems, providing user training and 
performing software installations and upgrades. Pre-Timbuktu 
Pro, you actually had to get out of your chair and visit the user 
or server to perform even the simplest task. In a campus 
environment where a server or user might lie a fifteen-minute 
walk away, the benefits of being able to control a machine at a 
distance are apparent. 

Unlike other applications with similar longevity, Timbuktu 
Pro has remained surprisingly lean and consistent over the years. 
There has been little feature bloat, and if you were a user from 
years ago, it would be like returning to your home town after an 
extended period away: things might look a little different, but 
you would have no problem finding your way around, 

I suspect that much of the reason that this is the case is 

because Timbuktu Pro fills its niche exceptionally well, has been 

extremely successful and Netopia has wisely decided not to mess 

with success. 

In version 6,03, Netopia has squashed a few 7 niggling bugs, 
added a feature to allow for limiting remote screen color depth 

in order to goose performance and allows for aliasing the TCP/IP 

Zones file used by the TCP/IP Scanner function in order to 
facilitate sharing the file with Netopia's Nc[Octopus, a software 
asset manager. With version 6,0.3, Timbuktu Pro on Mac OS X 
matches the performance and stability of earlier versions. 


Where To From Here? 

Timbuktu Pro is a great produce I have been using it for 
over ten years and it lias saved me countless hours and an 
endless amount of frustration in that time. It performs well, is a 
solid application that plays well with others and does exactly 
what it claims to do without fuss or bother. 

It just about owns its niche, but faces competition from 
Apple in the form of Apple Remote Desktop for screen sharing 
and file exchange. As legions of Macintosh programmers will tell 
you, you know you have a great product when Apple releases 
its own branded version. 

Given all this, it is hard to review a product w r ith such a 
Long, successful track record. Instead of talking about the screen 
sharing function, (it is great,} the file exchange performance, 
(functional and reliable/) or dissect the Preferences menu, (still 
blissfully straightforward and clear,) I will focus on areas where 
] think that the application could move forward and retain its 
competitive edge. 

Tins Isn't Yotit Father’s Macintosh 

With Unix under the hood of MacOS X, we have entered a 
whole new world of file permissions, file ownership, directory 
navigation and process management. The current version of 
Timbuktu Pro deals with many of these issues gracefully while 
adhering to the Mac OS interface. It would be nice, though, to 
see Timbuktu Pro embrace some Unix power user functions and 
tune up some interface features to reflect our new operating 
system environment. 

File Exchange Fun 

The feature of Timbuktu Pro that I have used the most over 
the years is the File Exchange function. It has saved me a huge 
amount of lime in checking to see what software lias been 
installed on remote machines and by providing a quick check to 
see if a remote server is up or down without incurring the system 
overhead of a screen sharing connection. 

The trusty user interface of side-by-side directory listings of 
the File Exchange function has not changed much since the 
Font/DA Mover pioneered this type of view. It Is time for a tune- 
up and some feature enhancements, though. 


Chris Kilhourn is an independent small business, network and web infrastructure consultant. Chris is also the founder of digital,forest, Inc., 
http;//www,forest.net, which offers database, application and web hosting services in addition to server colocation. You may contact him at chfisk@fore5t.net. 
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Figure / Timbuktu Pro's File Exchange Window 



NOTEBOOK- 


A welcome addition to die user interface would lx- a 
directory Favorites menu. 1 rind that when [ am transferring riles 
inbound to my computer, they are usually going to one or two 
places on a regular basis, and having to repetitively navigate to 
ihase directories cm become a tedious task. OS X's Gjx-n and 
Save dialog boxes have the directory' Favorites menu as a core 
user interface feature, and placing it in the File Exchange 
window would save keystrokes, mouse clicks and time. 

Another minor nil with this interface is the default local 
directory Timbuktu Fro starts you at the Desktop of the mot 
account. This view' should really start at your home directory or 
allow you to sei ihe default directory to begin browsing in. OS 
X saves your documents in your home directory's hierarchy by 
default, so why doesn't Timbuktu Fro? Having to navigate there 
every time seems kind of silly. 

For power users, l would like to see options to toggle 
viewing rile ownership, viewing group membership, the ability 
to change file permissions, viewing alias/Mnk targets, viewing 
rile size, viewing icons, show/hide hidden files and the ability to 
Hirer the list view by rile type or name. Tliis may sound like lots 
of feature requests, but the Unix Is, chmod, choum, thgrp and 
grep commands will perform these functions for you. Ihey are 
just waiting in /bin and /usr/bin to lx: tapped and utilized. 

Providing local and remote user and group views along 
with die ability to adjusL the user and group ownership, 0 choum 
and chgrp,) of remote riles saves a file downlmd/modify/upload 
cycle when you have a need to adjust remote file ownership. 

Using die ts command in Unix provides a wealth of file 
information, and you can expand or narrow the scope of 
information it provides by utilizing option flags. Providing a 
clickable unix-style file permissions listing, (i.e, - -rwxr-xr-,) 
where you could click on the permissions you wanted to enable 
or disahle would save having to go through tlx* process of 
downloading the file, changing the file permissions and then 
uploading it to the remote computer. 

Having a directory filename and file type filter, {grep,) 
would speed the fixation of an errant + html file that was 
misplaced in a graphics directory where there are hundreds of 
riles to sift through. Timbuktu Pro's search feature is very hist, 
but does not allow you to search within folders. 

By being able to toggle these Unix commands in Timbuktu 
Pro's File Exchange window, the exchange feature would be 
transformed into a sophisticated remote file management tool 
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Providing the option of selecting these features as general 
preferences coupled with the ability to create filter nr view 
preference sets would provide power users more control over 
file manipulation. Filtering out information from the list view 
might also provide a significant speed boost to the display of 
files in the File Exchange window. For example, if l do not want 
to see icons or file size, those are two less pieces of data that 
need to be fetched and displayed. 

Stupid Shell Tricks 

Old-school Unix system administrators were constantly 
searching for the most efficient combination of shell commands 
with the least amount of keystrokes in order to accomplish a 
given task. The command-line interface of the shell was 
continuously expanded over the years to allow all sorts of 
various and sundry file manipulation tools that provided 
sophisticated features, assuming of course, you knew they were 
there and knew how to apply them to the task at hand. 

One of the reasons why you might transfer a file with Timbuktu 
Pro is to do something with iL. You might need to edit if or email it 
off to someone, or merge it into another file you are working on. 

I know that I cannot count the numt>er of times I have had 
to download a file from a web .server that someone else created, 
then edit it, and then return it back to the .server. During this 
process, I have had to switch from Timbuktu Fro to die 
application 1 am editing the file in and then locate the file liefore 
I could begin work. 

A feature 1 would like to see in order to help alleviate some 
of this hassle is the ability to send a file directly to an 
application. (Crusty sysadmins will recognize this as the shell 
pipe feature.) Copying the file to your machine and then having 
it open up in the targeted application would save a fair amount 
of effort and needless clicking around. 

Borrowing a feature from Apple’s Safari, marking a directory- 
location with snap back would complete the process when it 
was rime to return the file. Timbuktu Pro does allow you to save 
connection documents which will place you in the directory you 
were browsing, but providing menu access via bookmark-type 
structure would go a long way towards making server farm 
administrators and help-desk technicians very happy. 

Oh, That File Goes There 

One File Exchange feature 1 have always coveted in the 
exchange function is the ability to move a file on a remote computer. 
*lhe only way to do this currently is to copy the file to your local 
computer, then re-copy the file to the proper directory on the remote 
computer, and then delete the remaining extra files at each end. 

This has always been a bother, especially when moving 
directories around. Some might argue that to move files or 
directories around, you should use the Control function. My 
counterpoint to that argument is that can take much longer to 
move files around on a remote computer via the control function 
if that computer is heavily loaded with processes or at the end 
of a low or constrained bandwidth connection. 

In the server environments 1 have worked in with Timbuktu 
Pro, I have dropped files into directories by accident when the 


screen redraw rate slowed down during a Control session. With 
the File Exchange function, you always know where you are at. 
directory-wise. 

Do You See What I Sef? 

The Control feature in Timbuktu Pro is the meat and 
potatoes of the program. It allows you to remotely dismiss a 
pesky dialog box, perform training or troubleshooting for 
remote users and view how many hits your web server is 
receiving when it is sitting in a data center on the other side of 
the planet. 

As before, this feature has l>ecn rock-solid over the years 
and it is diffic ult to say much about it other than the fact that this 
feature works, it works well, and the screen redraw performance 
is gcxxi In constrained bandwidth situations, you will encounter 
jerky remote mouse pointer beliavior and slow screen updates, 
but this is no fault of Timbuktu Pro, A screen redraw meter 
might be a nice addition to have in situations like that to confirm 
that it is the redraw that is slow, not your local machine. 

For all its success in screen sharing, 1 do have one major nit 
to pick about the Control function environment, and another 
feature 1 would like to see enabled. 

Back To The Future 

Try this thought experiment: imagine you are a brand-new 
Macintosh user that has only ever used Mac OS X. Now, initiate 
a screen-sharing connection in Timbuktu Pro, Now guess how 
long it will take you to figure out the window control features. 

That's right, there are no Aqua controls in the Look or 
Control windows of Timbuktu Fro. 


□ (Mlbanana.forest.net 12)0 


Figure 2 - Timbuktu Pro's Control Window Controls 

This may seem like a small issue to bring up, but software 
is hard enough to use as it is, and mixing control interfaces on 
a user violates user interface guidelines big-time. For a 
professional’s view on violating user interface guidelines, check 
out <http://www.asktog.com>. To paraphrase Tog, it is a bad, bad 
thing to do. 

There must be legacy code issues in Timbuktu Fro Lhat 
has prevented Netopia from adopting Aqua interface 
guidelines in the Look and Control windows; at least, 1 hope 
that's the reason. Here’s hoping they sort those issues ouL and 
are able to bring consistency to the windowing environment 
in the next release. 

Command And Control 

Raise your hand, if while using Timbuktu Pro in Control 
mode, you have inadvertently closed a remote window or quit a 
remote application by mistake. Raise your other hand if in doing 
this, it has caused short-term chaos for you to sort out. 

I’m the guy in the comer waving both hands above his head 
like he Ls trying to flag down a 747. 
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Number one on my feature request list for the entire 
application is the ability to suppress the transmission of 
command-key combinations to a remotely controlled computer 
via some sort of toggle switch, with the default being suppression 
and with the ability to override it on a per-session basis. 

Having l>ecn the victim of my own fingers, usually when 
low on sleep, in quitting remote server applications, it would be 
nice to have this safety feature to prevent user error. 


A Heretical Thought 

Software publishers and software users have reached an 
accommodation when it comes to features: feature requests are 
turned into coded features if it is cost-effective to implement 
them. The marketing and business calculus that drives this 
dynamic tends to lx* fairly clear-cut, and has provided us with 
software that does all sorts of things we need it to do, and some 
features that we perhaps do not use, but that a significant 
fraction of other paying customers do. 

When this dynamic breaks down and product managers 
approve every feature requested, we end up with applications 
that become huge, lumbering beasts that try to be everything to 
everyone, (Word 6 anyone?). Timbuktu Pro, thankfully, has 
always been a lithe application free of features that leave you 
scratching your head asking, "Who die heck needs to do that?" 

Operating systems change and the applications bundled 
with them change over time. Years ago, Apple shipped 
microphones with computers and monitors to encourage 
multimedia uses of the machines but they no longer do this. Text 
chat programs for the Macintosh used to be difficult to install 
and interoperated poorly, if at all With the advent of iChat, this 
is no longer the case. 

Lack of built-in microphones and the inclusion of iChat with 
OS X make the Intercom and Chat functions of Timbuktu Pro 
mostly superfluous and they should lx j purged from the 
application. Why burden die code base with functions dial arc 
either difficult to utilize, (by having to buy a microphone,) or are 
better implemented in another application (IChat)? 

The Bottom Line 

Timbuktu Pro performs as advertised, without quirks or 
crashes for screen sharing and file exchange. Low or constrained 
bandwidth situations will cause noticeably jerky screen redraw 
and slower file transfers, but that cannot be blamed on the 
application. The interface is straightforward, with its features anti 
options easily accessible via menus and key commands. 

Version 6.0.3 brings Timbuktu Pro for OS X into the solid 
performance anti stability realm thar the application enjoyed 
under die Classic MacOS. This reviewer hopes that future 
releases of the application will take advantage of the Unix 
underpinnings of OS X and make shell commands for file 
manipulation available when utilizing die Exchange function. 

Timbuktu Pro 6.0,3 for MacOS X is a deservedly 
esteemed application that should be an integral part of your 
software library if you have a need for remote screen sharing 
and file transfer. 
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QUICKTIME 

TOOLKI 


by Tim Monroe 


Studio 54 


Developing QuickTime Applications with 
AppleScript Studio 


In rhe Edit menu, we need to remove the items that don't 
apply to movies (the Find and Spelling menu items) and add the 
“Select None” item, as shown in Figure 14. 


Introduction 

In the previous QuickTime Toolkit article, we started 
building a QuickTime-savvy application using AppleScript 
Studio, In this article well finish up. 

Setting Up the Menus 

Let's turn to ScripTeez' menus. The Application menu is the 
easiest to configure, since we simply need to change the name 
of the application to “ScripTeez" in four instances, as shown in 
Figure 13. IVe also set he keyboard shortcut for the “Hide 
Others” item to be Comma nd-Oprion-H . as dictated by the Aqua 
Human Interface Guidelines. 


0 'lainMenu.nib - MainMenu 

| File Edit W indow Help 
About ScripTee2 


Preferences* 

Services 


Hide ScripTee2 
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Hide Others 

jznn 

Show All 
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Figure 1J : Ihe Application menu nib 


MainMeniurib - MainMenu 
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sv 

Clear 
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Figure 14: Ihe Edit menu nib 

All these items are handled automatically by Cocoa (and 
in particular, by the NSMovieView instance in our movie 
window), except for the one we just added. In this case, we 
need to attach an AppleScript event handler. As before, select 
the "AppleScript” panel in the Info window and then check the 
‘choose menu item" and ‘update menu item" handlers, as in 
Figure 15* Skeletal handlers are automatically added to the 
specified script file (that is, ScripTeez.applescript); well add 
code to those handlers later. 


Tim Monroe in a member of the QuickTime engineering team. You can contact him at monroe@apple.ccm. The views expressed here are not necessarily 
shared by hLs employer. 


48 


Studio 54 


MacTech • July 2003 





















o o 


NSMenuHem tnfo 


AppleScript 


D 


Nam t sefcctNon® 

Event Handlers 
T0 Menu 

3 choose menu item 
3 update menu item 
► S Nib 


Index: 10 


Script 

9? ScripTecz.applestript 


New Sc dpt Edit Script ' 


A 


Figure 15: The Select None menu event handlers 


Let's add one more menu to ScripTeez, a Movie menu that 
allows us to select a looping mode for the movie in the movie 
window. Figure 16 shows the updated main menu nib. 
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Figure 16: The Movie menu nib 

As you'd guess, we need to attach AppleScript handlers to adjust 
and handle these menu items. Figure 17 shows the Info 
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window for the third item in the Movie menu, the “Palindrome settings. We want SeripTeez to be able to open QuickTime 

Looping* item. Notice that the name of the item is movie files and Flash files. 

“palindromeLooping 1 , 
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Figure 18 : We openahlefile types 

AppleScript Studio Movie Classes 

Now it’s Lime to write some code to load a movie from a 
movie file and to handle the menu items we’ve added to the 
default menu bar. Recall that the only tiling we added to the 
default empty application window was a view of type 
NSMovieView. which we named “movieView’ . This name allows 
us to target AppleScript actions at that movie view. For instance, 
in the awake frum-nib handler, we might set a local variable 
theMovieView to point to diat view like this: 


Figure 17: The Palindrome Looping menu event handlers sel to the movie view "raovieView- of theObjeot 


Adjusting the Project Settings 

Before we launch into writing code to handle these events, 
we need to make a couple of final adjustments to our project. We 
need to add the QuickTime framework to the project, and we 
need to specify the kinds of files that our application can open. 

To arid the QuickTime framework* simply select "Add 
Frameworks.*. 11 in Project Builders Project menu and then 
choose the file "QuickTime.frameworkk It will lx: added to the list 
of linked frameworks. 

To specify the kinds of files our application can open and 
hence what kinds of files should lx: selectable in the file- 
opening dialog box (displayed at application launch time), select 
die "Edit Active Target^ item in the Project menu. Click the 
“Document Types 15 item on the left-hand side and add the 
desired document types. Figure 18 shows our document types 


(Recall that rhe awake-from-nib handler is passed the object 
dial's being awakened; in this case, it’s the movie window.) 

Ihii what vocabulary can we use to manipulate die movie 
view? To find this out, we can double-click the item labeled 
AppleScriptKit.asdictionary' in the project window (see Figure 
4 again). Expand die item labeled “Control View Suite 51 in the 
left-hand column, and then expand the Classes item. Well see 
a couple dozen view types, including “movie view”. If we 
click on “movie view 11 , we ll see the list of properties shown 
in Figure 19 
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Figure 19: The movie view properties 


This lisi shows us the built-in properties of movie views 
currently supported by AppleScript Studio. For instance, we can 
get and set the movie volume, the looping state, and the 
playback rate. We can get (but not set) the movie controller 
identifier. We can also get and set the movie associated with the 
movie view* So, we might set the movie to palindrome looping 
like this: 

set the loop mode of theMovieView to "* 

looping back and forth playback 

(The character AppleScripts line continuation character; we 
can insert it into a script by typing Option-L; this allows very 
long statements lo occupy several lines in our script files.) 

Loading a Movie from a File 

ScripTeez, youll recall, supports only one movie window. 
Well display the standard file-opening dialog box at application 
launch time, to elicit a movie file from the user. We can display 
that dialog box and get the full pathname of the selected file 
with tills simple command: 

set theHoviePath to choose file 

Then we can assign the movie in that file to the movie view like 
this: 

sot thfi movie of theMovieView to load movie theMoviePiUh 


Setting the Size of a Movie Window 

if you look back at Figure 7, you’ll see that the ^Visible at 
launch time" check box in die list of movie window attributes is 
unsdected; this is I because we don’t want the movie window to 
be visible while the file-opening dialog is displayed. Ifs also 
because, Indore we display the movie window to the user, we 
want to adjust the size of the movie window to exactly contain 
the movie at its natural size and the 20-pixel border on all sides 
of the movie view. 

The only problem is that AppleScript Studio does not (as 
far as I can determine) include any built-in method for getting 
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the natural size of a movie. The movie rect property returns 
the current size of the movie rectangle, which will just be the 
size of die movie view as contained in the nib file once we've 
assigned the movie to the movie view. Fortunately, 
AppleScript Studio supports an easy way to call code written 
in other languages, using the call method command. In 
ScripTeez, well need to use this command twice, first 10 get 
the natural size of a movie and second to handle the “Select 
None” menu item. 

Let’s look at the menu-handling task first, since it’s somewhat 
simpler than the movie-sizing task. When the user chooses die 
“Select None" menu item, we lt execute this line of script: 

call method "selectNone: 11 with parameter theWovieView 


To begin, let’s add two new files to the ScripTeez project; 

let’s call them ScrTzMethods.m and ScrTzMethods.h. Listing 10 
shows the file ScrTzMethods.h. 

Listing 10: Declaring a categ ory on NSAp piic ation 

SttTsiMclIitxIsii 

^interface NSAppiication (ScrTzMethods) 

(NSRec l) movieWindovContentReet:(NSMovieViev *)movieViev: 

- (void)selectNone:(NSMovieViev *)movieView: 

@end 

The file ScrTzMethods.m contains the actual implementation 
of the ScrTzMethods category. Listing II shows our definition 
of the selectNone: method. 


This call method command tells AppleScript Studio to look 
for an Objective-C method named "‘selectNone," and to call 
it s passing as its single argument the value of the variable 

theMovieView. 

When we issue the call method command, we can specify 
the class' whose method is to lie called. For simplicity, however, 
we’ll implement the selectNone: method (and the 
movieWindowContentRect: method, which well encounter in a 
moment) as categories on the NSAppiication class, 
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listing 11: Selecting none of a movie 

selectNone 

- (void) selectNone: (NSMovieViev *)mavleView 
| 

MovieCoutroiler me = NULL; 

TimeRecord tr: 

inc = (KovieController)[movieView movieController]; 
if (me != NULL) I 
tr,value.hi «■ 0; 
tr.value.lo = 0: 
nr.base = 0; 

tr.scale = GetMovieTim,GScale{ 

[ImovieView movie] QTHoviej): 
MCDoAction (ibc, rocActionSetSelectionlhiratiaii. &tr): 

1 


This is easy stuff that we’ve seen before. We retrieve the movie 
controller identifier from the movie view object, fill out a time 
record appropriately, and then call MCDoAction with the 
mcActionSetSelectionDuration action. Notice dial we do not return 
a value to our caller. 

Listing 12 shows our implementation of the 
movieWindowContentRect: method. As with selectNone:, it takes 
the movie view as the single input parameter. We retrieve the 
movie and movie controller identifiers, call 
GetMovleNaturaiBoundsRect to gel the natural size of the 
movie, and then adjust the rectangle to contain the movie 
controller bar (if it’s visible) and the 20-pixel border on all 
sides of the movie view. The recLangle we pass back to the 
caller contains the desired size of the entire content region of 
the movie window. 

Listing 12: Getting a movie window’s size 

mo vieWindwwCon teafftect 

- (NSRect)movieWindowCantentRarr:(NSMovieViev 4 )movieView 
I 

Rect rect = [0, 0, 0. 0); 

Movie movie ™ NULL; 

MovieConLrollet me = NULL: 

movie = (Movie) LtmovieView movie) QTMovie) : 

me - (Movie C out roller) traovieView movieControUer] : 

if (movie !- NULL) 

GetMovieNatnralBoundsRect(movie, &recl): 
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if (MCGetVisiblc(mc) — 1) 

rect- batLom +-=■ kContrullcrBarHeight: 

return NSHakeRect(0, U, 

(rect.right ■ rect.left) + (2 * kHovieWimlowftordcr). 
(rect.bottOffl - rect, top) + (2 1 kHovietfindawflorder) ); 

I 

What does our AppleScript cal! 10 movieWindowContentRect: 
look like? As with setectNone:, wo want to pass the movie view 
iheMovieView as a parameter. The key difference is that we need 
to capture the result of the method call, which we can do by 
copying that result to a local list of values, like this: 

copy (rail method "movieWindowContentRect: N 1 
with parameter rhoHovI pVJrw) to “■ 

(thel grmr t'Lf'f I . I hrTgnnreTop. tbeKovieVindWid, "* 

theMovieWindHgtJ 


We are interested only in the third and fourth items in the 
NSRect structure, which are the desired width and height of the 
movie window' content region. Once weVe got those values, we 
can determine the size and location of the movie window fairly 
easily. Listing 13 shows our complete calculation here. 


copy (call method "taovieWindowConrcntRect: * 
with parameter theHovieViev) to “* 
t the I guoreLeft. the I gnoreTop, theMovieWindWid. 

theHovleWindHgtI 

copy the bounds of the theWindov to 1 

ItheWIndhoft, theWindBottom, theWiudRight, theVindTopI 
set the bounds of the thoWlndow to 

ItheWindLeft. thcWIndTop (theMovieWindHgt + ^ 

theTitleflarllgl) , theWitidLeft + thcMnvIeWIndWld. “* 

tlioWindTopI 


Setting the Title of a Movie Window 

One task remains to be performed in the awake from-nib 
event handler; we need to set the title of the movie window to 
the basename of the movie's pathname. (The hasename is the 
jXMtton of the pathname that follows the rightmost path 
separator.) These three lines of AppleScript will do the job: 

net the text item delimiters to “;“ 

set theFilcNamc to (thcMoviePsth as string) 

set the title of the theVindow to ^ 

the last word of theFilcWane 


We can now make the window visible: 


Listing 13 ; Setting a movie window’s size 

set theTitieBarHgt to 20 


on j wake from nib 


show the window of theMovieView 
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Movih Playback 

At this point, the user lias selected a movie file using the 
file-opening dialog box; we Ye loaded the movie in that file 
into the movie view in the movie window and adjusted the 
initial size of the movie window as appropriate to display the 
movie at its natural size. AppleScript Studio, in concert with 
the relevant Cocoa classes, handles all subsequent user 
actions like moving or minimizing the window, starting and 
stopping the movie, editing the movie, and so forth. With 
very little AppleScript code indeed, and with just a small 
detour into Objeetive-C, weVe got a fu!ly~fimctioning movie 
playback application. 

We need to intercede here only to handle the menu items 
that we added to ScripTeez, namely the “Select None" item and 
the three looping state items in the Movie menu. 

Manipulating a Movie's Looping State 

As we saw earlier, a menu item can have two handlers 
associated with it, one that's called when the state of the menu 
needs to be adjusted Cor “updated") and one that's called when 
the menu item is actually selected. Hie update handler is called 
before the menu item is displayed to the user; typically this 
occurs when the user dicks somewhere in the menu bar. 
Listing 14 shows the complete update handler for our custom 
menu items. 

Easting 14: Ad justing the menus 

on update menu item 

on update menu item theObject 

get theKovieViev to movie view "movieVlew" of 

front window 

set theLoopMode to loop mode of theHovleView 

set enable] lem to l 
set dieekiiem to 0 

if name of theObject ie "eelectNorie* then 


if editable of thoNovlcView Is equal to true then 

set enableltent to 1 

else if name of theObject is "noLooping* then 
if theloopHqde is equal to normal playback then 

set checkltem to i 
set state of theObject to chackltem 
else if name of theObject is "normalLooping* then 
if theLoopHode is equal to looping playback then "* 

set check!Lem to 1 
set state of theObjeci to checkltem 
else if name of theObject is "palindronteLooping" then 
if theLoopMode is equal to 

looping back and forth playback then -* 

set checkItem to 1 
set state of theObject to chackltem 
else 

set enable!tern to 0 
end If 

return enableitem 
end update menu item 

Notice that we enable the “Select None" menu item only if the 
movie is listed as editable. Also, we set the state property of the 
looping menu items so that a check mark is displayed in the 
currently active looping state item. 

Handling the selection of one of our c ustom menu items is 
even easier than adjusting the menu items. We've already seen 
that we need to use the call method command to handle the 
“Select None" item* We can handle the looping menu items with 
pure AppleScript, as shown in Listing 15. 

Listing 15: Handling menu item selections 

on choose menu item 

on choose menu item theObject 
set theWindow to front window 

set theMovieView to movie view "movieView* of theWindow 

If name of theObject is "selectNone" then 

call method "selectNone;" with parameter theMovieView 
else if name of theObject is "noLooping" then 
set loop mode of iheMovieViev to normal playback 
else if name of theObject is "normaiLooping* then 
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set loop mode of theMovieView to looping playback 
else if name of theObject is K pali^d^o13^eLoopittg ,, ' then 
set loop mode of LltcMovlcVLew to -* 

looping back and forth playback 

end if 

end choose menu item 


Clctsing a Movie Window 

When the user quits ScripTeez, the movie window will 
dose automatically. In an ideal world, we would first look to see 
wheLher the movie in the window had been edited and then 
prompt the user to save or discard any changes* To my 
knowledge, however, AppleScript does not provide any easy 
way to update the movie data in a movie file. So we'd need to 
use the call method command once again to call out to Oljjective- 
C methods. I’ll leave that as an exercise for the interested reader 
ScripTeez does not provide any way to open a new movie 
window if we happen to close the movie window that\s 
opened at application launch time. Accordingly, we should 
probably set things up so that dosing I he movie window will 
cause ScripTeez to exit. Listing 16 shows the will-close 
method of the movie window, 

listing 16: Closing a movie window 

on will ebsc 

on will close rhoObjcct 
quit 

end will close 


Conclusion 

AppleScript’s English-like language makes our code 
extremely easy to read; 1 doubt that anyone would have too 
much trouble understanding even the most complicated scripts 
we've encountered in this article. We can use AppleScript 
Studio's built-in commands and properties to handle a good deal 
of what’s required to open and display QuickTime movies. 
Moreover, if need be, we can supplement our AppleScript with 
direct calls to Objective-C code to manipulate the Cocoa classes 
underlying our AppleScript Studio applications. This high-level 
scriptability and support for low-level method calling make 
AppleScript Studio an interesting addition to our QuickTime 
programming toolbox. 
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By Mirojurisic 

MindVision FileStorm 


Creating Mac OS X installers with 
FileStorm 

Introduction 

The way users install your products often makes Lhe 
difference between a happy user and a quick trip to the trash. 
Users know that confusion during the installation process is 
often a prelude to a baffling product. To make the best first 
impression, therefore, you need to understand the currently 
available software delivery tcxrls on Mac OS X, and balance your 
own requirements and those of your users. 

The range of possibilities is vast — from simple disk images 
and archives to complex interactive installers. This article 
reviews FileStorm by MindVision, a Mac OS X-only software 
delivery tool which allows you to create Mac OS 9 and Mac OS 
X disk images and Mac OS X installers. 

Overview of FileStorm 

FileStorm comes in two flavors, FileStorm and FileStorm 
Pro, FileStorm Pro is more expensive and offers more features. 
Both are royalty-free: you can distribute FileStorm installers and 
disk images without having to pay MindVision. 

The main difference between FileStorm and FileStorm Pro is 
that FileStorm can only create disk images, whereas FileStorm 
Pro can also create Mac OS X installers. As of this writing, the 
price of FileStom is $19,95, and of FileStorm Pro $79.95. 

Drag-And-Drop Installs 

Apple's recommendation for all Mac OS X software is to use 
a drag-and-drop install if at ail possible. This means that your 
users should be given a single item which they can install by 
dragging it into a location of their choosing in the Finder. 

This method of distribution makes sense primarily for 
software which doesn't need ro be in a special location in order 
to run, such as most applications. In contrast, a preference pane 
needs to be in one of /Library/PreferencePanes or 
-/Library/PreferencePanes in order to work correctly; 
consequently, authors of preference panes typically have to 
provide either an installer, or a document which explains ro the 
user how to install the preference pane. 


Even for software which can lie installed with a simple drag, 
you still have to overcome the hurdle of actually getting the 
software on the user's computer. If the user can download your 
software over the internet, you typically have to encode the 
software in some way. If you use resource forks (without which 
you cannot deliver software that works on both Mac OS 9 and 
Mac OS X), you have to use an encoding which preserves the 
resource forks. If you don r t use resource forks, your software 
almost certainly contains a Mac OS X bundle, which consists of 
several files and folders, and therefore needs to lie archived in a 
single file from which it will be extracted on the user's computer. 

An increasingly popular way of delivering files over the internet 
is Disk Copy disk images. Using a disk image allows you lo encode 
an arbitrary hierarchy of files and folders into a single tile. Their main 
advantage over other archive formats (such as Stufflr or gzip) is they 
integrate very well with the Finder: lhe user an view Lite complete 
hierarchy without going through a (possibly lengthy) decompression 
step, and you have full control over die visual layout of the hierarchy. 

Creating Disk Images With FileStorm 

FileStorm offers a very elegant user interface for creating 
disk images, and also offers access to advanced features of disk 
images, many of which arc nol available in Apple's Disk Copy , 

When you first launch FileStorm, a new project is created for 
you. A project consists of a disk image, which initially contains 
nothing but a custom background: 


Untllfctf 



Figure 1. A new FileStorm project 
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Manipulating the contents of a disk image us 
straightforward: drag files and folders in from the Finder, or add 
them using the Add Files menu command or the toolbar button. 
Once files anti folders are in the disk image, you can rearrange 
them in the File Storm window. 

If you need precise control over the files' locations, bring up 
the Inspector window from the Project menu to set items' 
positions with pixel accuracy, 

Unforunarely, FileStorm offers no advanced aligment and 
positioning tools. Its Align Horizontal and Align Vertical 
commands are very simplistic, and will suffice only for the 
Simplest disk images. 

Once you arrange the files, select Finalize Disk Image from 
die Project menu, and FileStorm will create a disk image that 
looks precisely as it did in your FileStorm project. You can 
mount this disk image and inspect it; by default, ii is created in 
your Documents folder. 

If you need to alter the disk image in a way that is not 
directly available in FileStorm, use the Build Disk Image 
command. This command creates a modifiable disk image for 
you to alter. Alter you are done with your changes, return to 
FileStorm and use the Finalize Disk Image command to build 
the final disk image. 

before you send the disk image to your users, you will 
probably want to change some of its settings from the defaults. 
To edit properties of Lhe disk image itself, make sure that no 
items are selected by clicking on the disk image background, 
and bring up the Inspector window. 

In the inspector, you can set the precise position and size 
of the main disk image window, as well as lock it against future 
modifications: this allows you to drag the FileStorm window 
around while you are working, without affecting the final 
location of Lite main disk image window on a user's screen. 


The General category of disk image properties lets you edit 
the name and the icon for the volume; when the disk image is 
mounted, it wall appear on the desktop with that name and icon. 
You can also configure the location at which FileStorm will put 
the disk image when it creates it, and add a background picture 
to your disk image. According to Mind Vision, FileStorm is 
currently the only tool that can produce a disk image with a 
background picture compatible with Mac OS X 10.1 and 10,2; 
disk images produced by other tools (including Disk Copy) fail 
to show the background image on either 10.1 or 10.2. 

The background image is separate from the FileStorm 
watermark, which shows up in the top left corner of your 
FileStorm project window; the purpose of the watermark is 
merely to let you easily distinguish between your FileStorm 
project window and the disk image you may have opened in the 
Finder. The watermark never appears in the final disk images, 
and it can be hidden using Lhe View menu. 

000 * Nlettcwm 1.5.1 _ O 


Figure 2. A finalized disk image, mounted in the Finder 
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The Format category of disk image properties lets you 
choose exactly what type of file will he created by FileStorm, 
FileStorm can create disk images compatible with Mac OS 9, but 
they require a resource fork so need to be additionally encoded 
if you intend to deliver them on the Internet. Encryption and 
compression arc also available, as well as several popular 
encoding format; Bin!lex, MacBinary, gzip, and bzip — the last 
two being only useful on Mac OS X. 

Your disk image can be set to open automatically after 
mounting, or to automatically extract its contents and move itself 
to the trash instead of mounting. However, not all versions of 
Mat: OS X work equally well with those two options; consult 
FileStorm help before you decide to use them. 

You can set the size of your disk image. If you don’t need 
to make any modifications to ii when you finalize it, you 
should let FileStorm choose the size automatically. Otherwise, 
set the size to either a fixed amount, or a fixed amount 
beyond the amount needed by the items FileStorm puts on 
the disk image. 

Finally, if you want to display a license agreement to your 
users, add your license agreement to the list in the license 
Agreements section of the disk image probities; the user will 
have to accept the agreement before the image can be mounted. 
You can provide several license agreements in different 
languages, and the one shown will be determined by the user's 
international preferences. 

Once you are done with your disk image, FileStorm can 
I sum it to a CD; your download and your physical media will 
thus have exactly the same look, pixebfor-pixeL 

Anyone who has ever created a disk image knows that it 
involves a lot of fiddling — moving Hies around in the Finder, 
setting their positions just so... when you need to update a disk 
image with FileStorm, all you need to do is open the FileStorm 
project and dick on the Finalize button. FileStorm will 
automatically grab the updated items off your disk and build an 
updated disk image with the hies in the exact positions in which 
your FileStorm project puts them. 

Creating Installers With FileStorm 

While FileStorm excels at creating high-quality disk images, 
its power doesn't end there. Following the lead of Apple's 
PackageMaker, FileStorm Pro gives you the ability to create Mac 
OS X installers with a simple, straightforward user interface, 
similar to that of Apple-s own installers. 

As you probably know if you've installed any of Apple's 
.software, Apple installers guide die user through a series of 
steps, including showing a license agreement and introductory 
documentation, selecting of a destination volume, and actually 
installing the software. 

FileStorm Pro allows all of I he same steps as Apple's 
PackageMaker, as well as additional ones: you can choose to 
show the user a graphic, an H TML file, or a QuickTime or an 
AVI movie. Furthermore, FileStorm Pro allows you to arrange ail 


those steps in whatever order you desire. Unlike Apple's 
Installers, which only allow you to present a set of three 
documents in a predefined order, FileStorm leaves you in control 
of the number and the order of the documents. For example, 
you can create an installer which shows one welcome 
document, installs some files, then presents a license agreement, 
and then installs more files. 

To create a new installer in FileStorm Pro, you use the Add 
Installer command in the Project menu. The installer is added to 
the disk image, and you can set its properties by doubleclicking 
ii to bring up the Inspector window. 

The General installer settings control some overall 
behavior of the installer, such as whether the installer needs 
the user to select a destination volume, or whether the 
installer needs administrative privileges to run. You can give 
your installer a custom icon and have it require a version of 
Mac OS X. 

If your installer is so complex that users might need an 
uninstaller, you can have the installer automatically create an 
uninstaller, and put it in a location of your choosing. 

Tiie main part of the installer is in its Actions. An 
installer action can install an item cm the user's system (at an 
absolute path, relative to user's home, or relative to the 
install volume) , or it may present the user with some 
information; installer actions can he UNIX scripts, which give 
you considerable power over in your installer, The main 
thing lacking from installer actions is the ability to affect the 
How of the installer itself; FileStorm Pro does not offer any 
ability for one installer item to influence another. That means 
that the user has essentially no control over the flow of Lhe 
installer; the flow is entirely determined by you at the time 
the installer is created, As a result, just as in Apple’s 
installers, you cannot have any optional install items; an item 
is either installed or it isn't. 

Setting up an installer is as simple as dragging all the 
installer files into the Actions list in the Inspector window (or 
adding them using the Add Files command). Once they are in 
the list, you can arrange them to taste and set the action for each 
file. Initially, the action of each file is Install Item, which means 
that it will be installed on the user's system. 

For any files which you do not wish to install on the user's 
system, you need to set the action to an appropriate value, such 
as Display Graphic (which displays a graphic to the user) or 
Support Item (which is used for Files which are needed by other 
parts of die installer — tor example, any images used by your 
Display HTML actions). 

When you run a FileStorm Pro installer, its behavior is 
similar to that of Apple installers. The left side of the window 
has a buletted outline of the installer process, and the content 
of the current installation step is on the right; you can assign 
each installation step a custom title which appears in the 
installer outline. 
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Figure 3 . ^ FileStorm installer in action 


If your installer needs to do something beyond the things 
directly provided for by FileStorm Pro actions, you have the full 
power of UNIX shell scripting available to you via the Execute 
Script install actions. Example scripts which come with FileStorm 
include changing ownership of permissions on installed files, 
opening files and folders, and adding login items to user's 
preferences. Since shell scripts can compile AppleScripts on the 
fly and execute them, you also have direct access to AppleScript 
from your FileStorm Pro installers; this is f indeed, how the Login 
Item sample shell script works. 

Finally, in addition to all the shell scripts you can execute 
during the installation process, you can have a script execute 
immediately after the installer launches, or immediately before 
the installer quits, using the Advanced installer settings. If your 
installer produces an uninstaller, you can add those two options 
to your uninstaller as well. 

Integrating Fiij-Storm With Your Build Environment 

FileStorm is fully scrip)able using AppleScript, which allows 
you to control it from any build system which gives you the 
ability to execute arbitrary AppleScripts or shell scripts. Both 
Project Bulkier and CodeWarrsor have this capability, 

FileStorm comes with a number of sample AppleScripts; 
they show you how to control every aspect of project building, 
from adding files and folders to a disk image, to finalizing 
images and manipulating installers. 

The main drawback of driving FileStorm via AppleScript 
is that it requires you to launch the FileStorm graphical 
interface in order to build a disk image. As a result, you 
cannot build a disk image with FileStorm unless you are 
physically logged in at the computer; doing it remotely via 
SSI I doesn't work. 

Most paths in the installer settings arc treated as project- 
relative if they refer to tiles which reside in the same folder as 
the installer project itself, or a subfolder of that folder. This 
allows a project to be moved from one computer to another. 
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Unfortunately, the location of the output image is not treated 
in die same manner, and as a result you have to be careful to 
use an output location which exists on every' system you plan 
to build the installer on; otherwise, when you move the project 
to a new' computer, you may get errors if the destination path 
doesn't exist 

The following shell script builds a File.Storm installer from 
Code Warrior: 

f !/bin/sh 

# Copy the application into the installer Input folder 
ditto rsrcFork "$ (MW_OtJTFUT_D I RECTORY 1 /Surf Write r .a pp* 

" $ (MW jDUTPilT_DIRECTORY ] / Ineta Uer /Binaries / Sur fWriter . app *' 
if Build the Installer using AppleScript via osascript 

# Note the try/quit/repeat loop -- FileStorm returns from the 

# finalize event before the image is finalized 
osascript -s o « EOF 

with timeout of 3600 seconds 
tell application "FileStonn" 
activate 
open 

({"$ lHU_0tJTPUT_01 RECTORY I / Installs c/SlirfWriT e r. fsproj * as 
F0S1X filej as alias) 
tell first document 

build image with replacing 
finalize image with rebuilding 
end tell 

repeat while true 
try 
quit 

exit repeat 
on error 
delay 5 
end try 
end repeat 
end tell 
end timeout 
EOF 


Summary Of FileStorm Capabilities 

If you want a simple drag-and-drop installation, FileStorm 
gives you a great w r ay Lo deliver your software with minimal 
hassle and a high-quality presentation. By using the option to 
automatically replace the disk image with its contents (only 
available on Mac OS X 10.2.3 and later), you get a self-extracting 
package; the only thing the user has to do after downloading it 
is double-dick. 

If you have a more complex software package consisting of 
a multitude of items, but do not require an installer, FileStorm 
lets you create a disk image with your software; you gel a high 
degree of control over the layout, appearance, and behavior of 
the disk image, and you can burn the software to a CD with a 
dick of the mouse. 

If' you need an installer for your software, FileStorm Pro 
offers a great deal of flexibility in customizing your installer, 
while retaining the simple and straightforward user interface 
pioneered by Apple's installers. FileStorm Pro installers are not 
without limitations; a big drawback for large software 
installations is the lack of control over installer flow. 


I lowever, if FileStorm Pro installers satisfy your needs, using 
a FileStorm Pro installer on a self-extracting disk image is a 
marvelously simple way to deliver an excellent installer with 
minimal hassle for both you and your users. 

Conclusion 

FileStorm and FileStorm Pro are both excellent products 
and priced very fairly. The user interface is superb, and has 
the polish of a well-designed Mac application — one that 
makes you feel in control of your project and helps you get 
your work done. 

No utility provides a user Interface for creating disk 
images that is cleaner or more powerful than FileStorm's. By 
using FileStorm to create disk images, you can save yourself 
a great deal of tedious fiddling in the Finder, as well as 
eliminate a bunch of specialized AppleScripts and shell scripts 
from your workflow, 

The user interface of installers produced by FileStorm Pro is 
elegant and familiar, and they provide flexibility significantly 
beyond that of Apple's Package Maker There are more types of 
install actions and their order and numbers can be varied much 
more so than with Package Maker. 

Two features of PackageMaker missing from FileStorm are 
the ability to create installers without being logged in at the 
computer, and the ability to create subinstallers (m eta packages, 
in PackageMaker parlance). 

Unfortunately, there is no way to dynamically control the 
flow of a FileStorm Pro installer at runtime. If you need the 
ability to conditionally install an item based on the state of user's 
system or input from the user, you won't get very far with 
FileStorm- MmdVLsionS current recommendation is that you get 
a copy of Installer VISE, their flagship installer product for Mac 
OS 9 and Mac OS X. 

However, once you've used FileStorm, using Installer VISE 
is a significant setback in elegance and ease of use; installers 
generated by Installer VISE are less straightforward less 
coherent than the ones generated by Pile Storm. 1 can only 
hope that using Installer VISE is a temporary workaround, and 
that MindVision will enhance FileStorm so that it can more 
effectively compete with Installer VISE on Mac OS X — both 
because FileStorm is much more pleasant to use, and because 
it makes my users' lives lietter. 

FileStorm Pro installers require Mac OS X, so if you need a 
Mac OS 9 installer, you have to use a different product (possible 
Installer VISE); however, if you only need a disk image to deliver 
your software, FileStorm does allow you to create ones that 
work on Mac OS 9 and Mac OS X. 
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computers as if you were sitting in front of them, transfer files or folders quickly 
and easily, and communicate by instant message, text chat, or voice intercom, 
http: / / www.ti m bu ktu pro.com 


netOctopus 

Intuitive and powerful, netOctopus can manage a network of ten or 10,000 
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software; configure remote computers; and create custom reports on the fly. 
http: / / www.netoctopus.com 
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UNTANGLING 
THE WEB 


By Kevin Hemenway, Questionable Intender 


User, Meet Apache. Apache, Hug. 


Or: How To Learn More About Your 
Cuddly New Web Server. 

Hopefully, if you were at all interested in the hist column 
{MacTech. June 200J), you've mentally prepared yourself for 
the coming months of web serving hemming and hawing 111 
continue to assume that you know more about your own 
network and internet provider than I ever could, and as such, 
will only touch briefly on ISP-related workarounds. In this 
installment* well turn on our web server* explore its 
directory structure* and Learn how to interact via the 
command line. You should know how to operate Apple’s 
Terminal application - if you don’t* l highly recommend 
brushing up on Chris Stone's series* Learning the Terminal 
in Jaguar, on MacDevCentercom. 

IiARTMAN: Today You People Are No Longer Maggots 

A word of encouragement: 63% of the web sites on the 
Internet are using Apache (according lo a 20(12 report from 
http://fietcrafLcom/). Apple, convincingly enough* has Included 
Apache in its own OS X and OS X Server products, h isn’t a 
“ported" version or a slimmed-down feature set, but rather a 
full-fledged implementation of Apache with all the lixin's. 
Much of what you learn in these articles will apply to any 
installation of Apache, regardless of whether it's on Mac* 
Linux* or even Windows. 

If you're familiar with the differences tier ween Mac OS X 
and Mac OS X Server* you're probably aware that Server contains 
more GUI based administration tools for programs like Apache* 
sendmail or MySQL. This doesn't indicate that one Apache is 
better than the other everything you ran do in Server can lx? 
done in the consumer OS* and vice versa. As of this writing* 
these articles assume youYe using the consumer Jaguar* anti not 
the Server version (which we won’t be covering). 


Alternatively* a word of possible disillusionment: much 
like any web developer worth his salt will use a raw' text 
editor like BBEdit (which I prefer* see 
http://www,barebonesxomf) to code their HTML, most system 
administrators eschew the need for hand-holding GUI tools 
and dive right into text editing a configuration file. This is 
decidedly tin-Mae-1 ike but* until a few years ago, so was the 
thought of including Linux (or* more accurately, BSD) as an 
under layer* If you want to become proficient at web serving 
or programming* you’re going to have to get used to editing 
configuration files* Yes* there are GUI based tools available, 
but you’ll do a lot better if you learn fo fish, rather than 
plunking quarters into a vending machine (that made sense* 
right? Right!) 

Enough soap-boxing. Commence the casting, 

KAHN: Butterfly In The Sky,,. I Can Fly Twice As High! 

There are a few different ways you can get a rise out of 
Apache, the most immediate of which is through the Macintosh 
GUI. In Jaguar, this setting is hidden underneath the Sharing 
System Preference; open that now {Apple Menu > System 
Preferences, > Sharing). The first tab we see* Sendees, lists a 
number of capabilities we can turn on or off, as well as our 
current network address (which may or may not be accessible to 
the outside world). 

In Figure 1 , you’ll see that "Personal Web Sharing" has been 
highlighted. To turn our Apache web server on, either put a 
check in the box on the left* or click the “Start” button on the 
right. A few seconds later, we ll see the results shown in Figure 
2. Of special interest is the new information at the bottom of the 
screen - the first URL is the home of the primary web site of your 
machine* and the second is the address of the current user’s 
personal web site. 


Kevin flcoicnway, coauthor of Mac OS X Hacks, is better known as Morbus Ilf* the ovator of disobey.com, which hills Itself as “content for the 
discontented/* Publisher and developer of more home cooking than you could ever imagine (like the popular open-sourced aggregator AmphetaDesk, 
the best-kept gaming secret Gamegtefiecorn* articles for Apple’s Internet Developer and the O’Reilly Network, etc.)* lie’s an ardent supporter of writing 
incorrect passwords on sticky notes, just to confuse peepers. Contact him at morbus@disobey.com. 
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Figure 1. The Services tab of the Sharing System Preference. 
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Figure 2, 1 he Apache u?eh server has been started . 


Depending on your network or ISP's configuration, you 
may be able to type (or ait and paste) those URLs into your 
browser’s address bar and see the default pages of your built- 
in web sites (Figure 3 and Figure 4). If you don’t see those 
pages, or else get an error message concerning connectivity, 
you should run through some of the steps in last month’s 
column to iry and determine your external IF and whether it's 
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viewable to the outside world. For now, you should be able 
to follow along by using http://127.Q.0.W and 
http://127.0 0-1/~U5ername/ respectively. 

Figure 3 shows the default web page that is shipped with 
most Apache distributions - it's just a quick confirmation that the 
Apache web server is up and running smoothly. Ultimately, you 
should see this page only once (that once is now). You’ll also lie 
informed that the Apache documentation can lie accessed from 
http://! 27.0.0.1 /manual/. 


S n T«r Pagt for A^che Installation 

Ear A ] j O - j + j P http./,f 127.0.0.1/ 


Q- lo^it J % 

ttmWaumMgrmnamM 


If you can see this, it means that the installation of the Aa ache web server software on 
this system was successful. You may now add content to this directory and replace thi 1 
pa<je. 


Seeing this instead of the website you expected? 

This page is here because the site administrator has changed the configuration of this 
web server. Please contact the person responsible for maintaining this server will 
questions. The Apache Software Foundation, which wrote the web server software this 
site administrator is using, has nothing Lo do with maintaining this site and cannot he! 
resolve configuration issues. 


The Apache documentation has been included with this distribution. 

Von are free lo the Image below on an Apache-powered web server, Thanks for 
using Apache! 


_ 


Figure 3* The default root u?eh page of Apache. 


Figure 4, on the other hand, shows a friendly blurb that 
Apple created to ease new users into their virginal web serving 
experience, li briefly covers what we just did (turning on the 
web server) as well as quick definitions of HTML and Apache, 
You should read over both the default pages - you'll probably 
be deleting the files that represent them shortly. 

Bur, where are these files physically located? The first 
URL, being the root location of the web server, is served, 
semantically enough, from the root web directory of Apache: 
/Library/WebServer/Doeuments. The second URL, being user 
specific, is served from /Users/usemame/Sites {as explained 
in Figure 4). 

And that, as they say, is that. Your Apache web server is 
running, you're seeing the default web pages, and you could 
publish vanilla HTML with nary a peek at die underlying 
sprockets and cogs. So far, though, this hasn’t been very 
satisfying. It's hard to feel good about yourself when all you did 
was dick a button and piddly-type a URL. 



Your website here. 


Now you can use Mac OS X Personal Web Sharing to publish web pages 
or share files on the Internet — or on your company"* (Or school 1 si 
local area network — from a folder on your hard disk. 

You can display your documents on the internet - or restrict access to 
a chosen few within a local area network. Mac OS X Personal Web 
Sharing makes it a snap. 

Mere’s how it works: Once you're online, all you need to do is copy a 
file in HTML formal lo the Web Pages folder fin the Sites folder in your 
te xjifp-ttm*. on.vnut rmnnutet's hard diski. and.LhaCsJL.Vgu^ 


Figure 4 . The default user web page from Apple r 


BA3TSE (TRANSLATING): If No Pain, Nothing Good Ls Born 

Being speltinkers of the technical sort, however, it's time we 
dig deeper. To do so, well open up a Terminal and type httpd - 
V which gives us the results shown in Figure 5. What we’re 
doing rs asking Apache (represented by the shell program httpd) 
to show its compile time settings. These will change depending 
on your distribution (Redhats output will be different from 
SuSF.’s output, which will l^e different from OS X's, and so forth). 
I ll explain some of the more important entries below. 

Note: The screenshot, and my explanations, are based off 
version 10.2,6 of OS X. Tf you're following along with 10 I 
(waiting for Panther, eh?) or earlier versions of 10,2, you may 
see a slightly different output. Don't fret,., the differences 
rarely equate to much importance, and when they do, 111 make 
a glib comment. 


@@© 


Terminal - bash — bash (ttyp?) — 78*2S 


•OTtnwAJimt^y:- > httptt -V 
:Server version: Aeoebe/1.3.i27 fDandn) 

: Server built: 10/16/02 21 :4B; 17 
; Server^ HdduLe Jtagtc Hunter: 1994G3£0:L3 
! Server ce#pll«i with.... 
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-0 DEfAULT_PIDLn>.-^ar/tWmt(id .ptcT 
-4> DEFALLT_«XKEBQAHX.’A^/ruVhttpd .KBreboord' 
-D DEFAULT ^LDCKF J ££=*Aw/naVhittDd , Loe* H 
-0 DEFALi.T_EI!Rl)RLGGe */yQt/ Log/httpd/ErrOr,. Log 1 ' 

4> TYPES_i:WFie_FILE-Vetc/httpd/»ifcs ,typ«' 

-f> S£RVEft_C0hF LE-Vete/httpd/httpd .ernf" 
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Figure 5. The results of art httpd -V shell command. 
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A server to distribute dynamic visuals to the web and printers. 

Vvidget Fusion™: 
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Vvidget Signals™: 
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Vvidget User™: 

A graph building tool, palette, and preconfigured graphing server. 

Ltfnited Time Offer; $89 (S49 for students) (this ad made with Vvidget User) 
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Data From Any Source 
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The firsi bit of info is the server version of the currently 
installed Apache (and, for the esoteric, the timestamp of when it 
was actually compiled). Thankfully, Apple has generally been 
responsive with their security updates, and most OS X users are 
running the latest release (13-27, although, at die time of this 
writing, there were rumors of an impending 13,28). 

The next line worth exploring is -D HTTPD_ROOT, which 
Leifs us where the Apache binaries have been installed. The nicxsi 
important files, like httpd and apachectk live in /usr/sbin. Ail of 
Apache’s modules (read: plugins) live in /usr/libexec/httpd. If 
you’ve had experience with Linux programs before, this layout 
is relatively familiar. The next line, concerning SUEXEC BIN, can 
safely he ignored - suexec isn't enabled or shipped under OS X 
(we can, however, recompile Apache and add it ourselves, Long 
story. Eventually.) 

-0 DEFAULT_ERRORLOG, the next entry of importance, is 
probably the single greatest answer to all your problems before, 
now, and after. Whenever something goes wrong, check your 
error log. Whenever something goes right that shouldn't have 
gone right, check your error log. Whenever you suspect 
someone is chuckling behind your back, the error log will have 
their home address, “Check your error log” is the Apache 
equivalent of "RTFM" before m-the-know users will answer 
any of your tech support questions, they'll want to know what 
the error log says. More often than not, the error log will tell you 
exactly what went wrong. Don't be embarrassed Check your 
error log. Thu quickest and most helpful way is with tail 
/var/log/httpd/errcr log which spits the last ten lines of any file you 
pass to it. 


Well talk a bit more about tog files in an upcoming column, 
but for now t realize that a matching /var/log/httpd/access log 
covers successful operations (in the sense that the original URL 
request garnered a "proper" response), in previous versions of 
OS X, you would have seen a matching -D 
DEFAULT_ACCESSLOG in Figure output. This has since 
moved inside the configuration file, which is what our remaining 
four lines cover. 

Tlie first of the last, /etc/httpd/mime.types, contains the 
mapping between a file extension and the MIME type sent to the 
browser (or, more genedcally, the "requesting user-agent"). For 
now, well leave the actual definition of MIME types to a later 
column, but if a .jpg were served as text/html (and not its proper 
image/jpeg), then the browser wouldn’t be able to properly 
render and display the picture. 

The next entry is The Ihg One - /etc/httpd/httpd.conf 
points to the file that handles al! the configuration of our 
Apache web server. It’s suitably large, suitably commented, 
and suitably intimating, enough so that the included early 
warning should be taken to heart: Do NOT simply read the 
instructions in here without understanding what they do. 
They're here only as hints or reminders. If you are unsure 
consult the online docs , You have been warned, The last two 
entries in our (mlput can be safely ignored - they’re 
deprecated configuration files that have since been merged 
with the master configuration. If you get caught using them, 
your error log will spit out my home address. 



Make Drawing Fun on OS X 


Introducing EazyDraw - the fun r easy-to-use Mac OS X 
design tool that lets you draw tike a pro! Now you 
don't need to be a graphic artist to create great 
illustrations. Eazy Draw's vector-based graphics and 
editing capabilities make it easy to create technical 
diagrams, flow charts, and business communications 
as well as commercial line art illustrations and graphic 
elements for application software and web design. 

Learn more about EazyDraw today! Got big savings 
buying direct from our online store. Visit us at 

www.eazydraw.com 

(That's easy with a Z), 

® ?0Q3 DekQfrs optics, LUC- AH’ rights, reserved. 

EasyOravu and me ‘box el tools’ are trademarks ol Oakorra Oplies. LLC, 
Mac and Brnll tor OS X ana trademarks of Apple Computer, !nc 
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HAMMOND; Au Major Theme Parks Have Delays 

If you recall from the first column, one of rhe ways an TSP 
can put a dent in your web serving plans is by filtering 
incoming HTTP traffic. With such a filter, any incoming requests 
on port 80 will be dropped, and they II never reach your 
anxious and ever-ready Apache. Working around this is easy 
enough to serve as an introduction to editing the master 
configuration file, Note: For those who DON’T have an evil ISP, 
just mentally follow along - you’ll have less mundane things to 
do come next column* 

The first hurdle concerns saving our upcoming changes to 
/etc/httpd/httpd,conf. This file, being “special", requires heighten 
privileges to allow modifications - privileges that your user 
account doesn’t have by default. To get these special 
administrative privileges in ihe Terminal, you'll need to preface 
your intent with the sudo command. Said command gives you, 
for that one instant, super powers - enough so to save your 
changes to an otherwise protected file. The downside of using 
sudo is that you need to l^e proficient in a shell editor like pico, 
emacs, or vi. 

Myself, 1 prefer BBFdit 7.0’s shell utility (which ran be 
installed via their Preferences > Tools > Install a hbeclil ' Tool). 
BBEdit’s utility is smart enough to know that when you attempt 
to save a protected file, you should be prompted for an 
administrative password. In my case, 111 launch into our next 
paragraphs with bbedit /etc/httpd/httpd.conf. For those without 
RREdif, utter sudo EDITOR /etc/httpd/httpd.conf where EDITOR is 
your preferred program of choice. If you Ye new to shell editing, 
there’s a quick tutorial on using pico in Chris Stone’s 
MacDevCenter.com series* 

However you get there, we should now be looking at 
Apache’s primary configuration file. Within the first screen of 
information, you should see the warning i italicized above, and 
I'll warn you again: here they be dragons. Friendly Fuff-like 
dragons, but dragons nonetheless. 

In general, when you want to modify the configuration of 
Apache, more often than not, just do a search for your desire 
and you'll find something worth investigating. In our example, 
we’ve got problems with the ISP filtering port 80 traffic, so do a 
search for the word “pen". You will find, soon enough, the 
following bit of text: 

* Port:The port to which the standalone server listens. 

* For ports < 1023, you will need Impel to be run as mot 

* initially. 

* 

Fort 80 

Here, you can see that Apache has been configured to sLart 
up on the default (and expected) HTTP port 80. Since our 
theoretical ISP has blocked that, we need to change it to 
something else. Good alternative choices are 8000, 8080, or 8088. 
Sadly, whatever you choose will turn all your URLs ugly., , if you 


chose 8000, you’ll be forced to give out 
http ://127.0.0.1 iSOOO/- morbus/ instead of http://127.0*0.1 /-morbus/. 
Choose your poison, and save the file. 

Since we’ve made a change to the configuration, we’ve now 
got to restart Apache* You’ll become familiar with these steps as 
the column progresses: any time it change is made to the 
configuration, it won’t be put into play until Apache is stopped 
and then started. Before we actually do that, it’s often handy to 
run httpd -t first. Much like -V gave information about Lhe built- 
in compile time settings, 4 gives us some insight on our 
configuration file by testing it for errors. If everything’s grand, 
well gel a Syntax OK... if not, well be told on what line we 
actually screwed up. The benefit of testing before restarting 
should be obvious - it gives us a chance to fix problems before 
our visitors start complaining. 

We can restart Apache one of two ways: by toggling the 
buttons in our Sharing System Preference (refer back to 
Figure 1 and Figure 2) or by using the apachectl shell utility. 
1 personally prefer Llie shell utility, due to a shortcoming in the 
System Preference: if your httpd.conf has an error in it, the 
System Preference will attempt to “start” indefinitely, 
expecting a positive response that it will never get. With 
apachectl restart (or its implied brethren: apachectl stop and 
apachectl start) you'll be given an httpd -t diagnosis if anything 
goes wrong. Once Apache is restarted, the configuration 
change has taken effect, and you should be able to visit your 
newly tweaked http;//127.0,0.1:8000/-morbus/ (or whatever 
actual port you chose). 

Homework Maugnments 

In our next column, well begin exploring our first major 
feature: server side includes. Often ignored for being Too 
simple”, they can do some fairly useful things willtout much 
effort. Until then, students may contact the teacher at 
morbus@disobey.com. 

* Peruse through the /etc/htlpd/hUpd.conf, Familiarize 
yourself. 

* The Apache documentation already loaded on your machine 
(see Figure 3) is some of the best open source 
documentation around* I’ll refer to it from time to time. 

* Liked reading about URL design from the first column? Check 
out “Toward Next Generation URLs" by Thomas A, Powell and 
Joe Lima: http://port80software.com/support/articles/nextgenerationurls 

* Complete the ever-enlarging animal tree: maggot, butterfly, 
what, and what? 

■ Bach of the headings is a quote from a movie or T V show. 
Name them. 
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MAC 05 X 

PROGRAMMING 

SECRETS 


By Scott Knaster 

Panther and G5:The Future is Almost Now 


This month we take a detour from our usual dusty dirt road 
to examine, MacTech-style, Steve Jobs' keynote speech at Apple's 
Worldwide Developers Conference 2003 in San Francisco. 

A Sunny Day Around The Bay 

This past spring, Apple announced that it had moved 
WWDC in time and space, relocating from iLs traditional May 
dates in San Jose to June in San Francisco. But the biggest 
change was the buzz that WWDC had stepped up in rank and 
was now to host an Apple product announcement of die 
highest order, 

The conference was held at the wet-paint-new Moscone 
West venue. You can tell how modern this place is when you 
visit the bathrooms: there are motion-sensitive automatic paper 
towel dispensers. When I saw these, I wondered if I was 
witnessing one of Apple's big technological announcements of 
the day. But I wasn't - Apple hasn't gotten itself into sinktop 
computing just yet. 

As with any Steve Jobs keynote, there was electricity in the 
air and the lines for the keynote hall formed early. Just before 
the scheduled 10:00 AM start, the doors opened and the 
attendees surged in. Apple's crowd-control folks were heard to 
ask people not to run. Everyone found a seat. 

Anticipation 

As we waited for the show to begin, everygeek ux>k out a 
PowerBook or iBook and began idly scanning the Internet. It 
s(x>n became apparent that Airport access wasn't working very 
well. So enterprising attendees starting selling up computer-io- 
computer networks and using the names of the networks 
themselves as a form of communication. Some of the first few 
networks to appear were named "airport not working again", "l 
love steve jobs", "I'm running a 970 pboak", and the clever and 
enticing "Steve Jobs' computer". By using the names of networks 
to converse, Mac developers in the crowd fulfilled the old saying 
that "Eventually, every application expands until it is able to 
send e-mail," 


By using MacStumbier, an open source utility for sniffing out 
wireless networks* I was able to take a snapshot of this playful 
networking (see Figure 1). 
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02:00:DA:A1:E6:24 

It 

18 

Ad-hoc 

macosxlabs 

02:00:8 C :6E :62:4 3 

11 

25 

Ad-hoc 

we are geeks liking with essids 

Q2:0G:F8:D3:F3:23 

11 

24 

Ad-hoc 

MacMedics 

02:00 B3 15 44 DC 

1 

27 

Ad-hoc 

SNAPPLE 

02:00: 5F:B A; DO: 2 B 

1 

25 

Ad-hoc 

Memo: stop whining! -Sieve 

02:00:92:68:17:18 

11 

27 

Ad-hoc 

Apple Store Position Opening 

A6’E5:86;C7:D7:D8 

10 

23 

Ad-hoc 

and lo think i was going to work 

02:00:08:24:08:04 

11 

16 

Ad-hoc 

Steve Jobs' Computer 

02:00:71 :C9:9E:C9 

11 

27 

Ad-hoc 

heaven forbid we leak something 

92:60:3F:13:1A:63 

1 

14 

Ad-hoc 

GAWD THIS IS PATHETIC 

32:19:32: E9: CC :F C 

11 

17 

Ad-hoc 

1 love Steve Jobs 

02:00: D F: E9: □ 7:76 

11 

25 

Ad-hoc 

NO AIRPORT AGAIN?????? 

02:00:38:40:11:5C 

11 

26 

Ad-hoc 

2GHz 970 Machine...Really 

66:85:29:60:1P:FB 

1 

18 

Ad-hoc 

ntwk running on msfl i guess 

02:00:2£: C6:2E:36 

11 

19 

Ad-hoc 

Ifee! the RDF already!!!! 

02:00:22:91:57:96 

11 

27 

Ad-hoc 

Log live iBook, they get connects 

Q2:QG:AB:92;EB:34 

11 

26 

Ad-hoc 

Nope, Don't think so. 

02:00:01:00:09:94 

11 

31 

Ad-hoc 


Figure 1 . With Internet access failing, clever geeks at the 
WWDC keynote expressed themselves via the names of private 
net works they created . 


Scott Knaster lias l>een writing about Macs for as long as there have Iseen Macs. Scott's books How To Write Macintosh Software and Macintosh 
Programming Secrets were required reading lor Mac programmers tor more than a decade. Scott wrote developer hooks for General Magic and worked on 
Mac software (or Microsoft, Scott's books have been translated into Japanese and Pascal. Scot! has every Issue of Mad magazine, which explains a lot. 
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Ask yourself this question 


use my Mac for: 


_j Programming as a hobby 


Exploring the depths of Mac OS X 


y li!' 

L ■ * 


j QuickTime Development 




Application Development 


Network Administration 


All Of The Above 




The Journal of Macintosh Technology and Development 

y ° U ** r#9r ° m as a hobby or are a full-time developer/ 
ecb gives you the info you need from the people that know. 


1 " ' 


•|i>Jl/r?e B 877 5 MACWr t H kC n i "T\^ * ,U5M20 ° * «^@ ma ct ct h.com 

. 1AC1 tCH • Outside US/Canada: 805494-9797 ■ Pan: 805-494-9798 











Steve strode out without introduction (everybody knew 
who he was anyway) and commenced his presentation with a 
review of what’s happened recently and how things are going. 
He announced impressive numbers for AirPort Extreme ("1000% 
sure 11 that 802.11g is the successor to 8021 lb) T Apple retail stores 
(58 stores opened in 25 months so far, with cool new giant 
stores that look like enormous iPod boxes coming Lo Chicago, 
San Francisco, and Tokyo), and iPod (1 million shipped and 5 
million songs purchased at the iTunes Music Store). He 
announced that Safari TO was now available, along with a 
framework that lets you build a browser core into your own 
apps with incredible ease. 

Of course, nobody was ihere to hear that stuff: they 
wanted to find out what was new. Steve kicked off that 
portion of the speech by talking about w r hat was going on 
with OS X. Again with the impressive numbers: 7 million 
active users, 6000 native applications, more than 300,000 
active developers, and 100 major new features in Panther, 
a.k.a. Mac OS X 10,3, the new version of OS X that everybody 
came to see, Steve then bundled into an extensive demo of 
some ("we don’t have time to show them all 11 ) of the new 
Panther goodies. 

The most visible new Panther features are in the Finder. 
Haters of brushed metal will have issues with the Panther Finder, 
although loyal Mac OS 9 folks will find a few old favorites 
restored. The mantra for the Finder’s new features is "user- 
centric, not computer-centric' 1 . To that end, Apple lias added a 
customizable column of common icons at the left side of Finder 
windows, including your disks, home folder, and others (see 
Figure 2), This feature is sufficiently raw enough that Apple's 
department of cool marketing names had not yet taken a firm 
hold of it: Jobs referred to it as "the left column", although 
Apple's web site refers Lo iL as the Places sidebar. It gives the 
Finder a look that’s reminiscent of iTunes and the other iApps, 
which is no doubt intentional. 



Figure 2. 7 he new Finder includes a column of icons at the left. 


Speaking of iTunes, another cool new Finder Lrick is 
interactively winnowing a list of files, iTunes-style. The search 


box in the upper-right corner of Finder windows lets you 
quickly narrow the list of files you’re looking at. This handy 
feature also shows up in the file browser for Xcode, Apple’s nifty 
new developer environment. 

The new Action button in the toolbar shows thai Apple 
understands the power of contextual menus and the problems 
of discoverability. Clicking this button brings up a list of actions 
that varies depending on the selected object, and you can get 
the very same list by control-clicking (or right-clicking, because 
"some people have two-button mice’ 1 , as Steve acknowledged) 
on the object. 

Panther includes new and improved Open and Save 
panels. The Places sidebar appears here too, which gives you 
easy access to your disks, including network volumes. You 
can look at your files in a list view or column view. See 
Figure 3 to take a took at the new Save panel. Another 
much-requested feature from OS 9, file and folder labels, is 
back in Panther. 
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Figure 3, Panther Save panel 

One of the coolest bits of iCandy introduced by Apple is 
a new feature called Expose. Hmm, Expose, 
Rendezvous..,those French guys at Apple are Infiltrating Lhe 
department of cool marketing names! Expose is a solution to 
the problem of finding the window you want amongst all lhe 
windows on the screen. Expose zooms all your windows down 
to miniature size and arranges them on the screen so you can 
see and pick the one you want. Because it's from Apple, 
Expose works with flair, smoothly animating all the window- 
moving business using Quartz Extreme. See Figure 4 for an 
idea of how this looks, but you’ll have to actually watch it in 
action lo get the full thrilling effect. 
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Figure 4 . Rxpose shmvs allyour windows at once, in miniature. 

After showing off the Finder, Jobs introduced iChat AV, a 
new version of the instant message program, now featuring 
voice and video chatting, or as Jobs called it, 
"videoconferencing for the rest of us*. To show off iChat AV, 
Steve video-chatted with a friend in Paris and even took a call 
from Apple board member and former U,S< Vice President Al 


Figure 5. Font Book lets you see and manage fonts in Panther 

I lere are some of the other new features in Panther that Apple 
has talked about so fan 


Gore. When told he was the second person ever to appear in 
a live iChat AV chat, Gore looked disappointed and said "Being 
first is difficult 1 '. Apple also shipped a camera, called iSight, to 
use with the new software. 

The new Font Book feature adds tots of power to font 
management in Panther. You can search for fonts by family and 
typeface, group font effects, and customize the set of fonts you 
can see in an application (see Figure 5)- 
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A new version of Preview that's much faster than the 
one in Jaguar. Jobs demonstrated very fast scrolling through 
an enormous PDF doc the PDF spec itself. Self-reference: 
whoa! This new version also performs searches much faster 
than before. 

Every print panel now has a Fax button built in. That’s very 
cool, although probably less so to companies who make fax 
software for OS X. 

There's a new edition of Mail that's faster (of course!), lets 
you drag and drop addresses around when addressing a 
message, handles threads, and uses Safari's rendering engine to 
display HTML. 

Fast User Switching, which according to Steve is "the only 
feature we've copied from Windows", lets you quickly change 
users without having to log out or even quit apps. For the piece 
de resistance (I’m trying out this French stuff too), Fast User 
Switching employs a supercool graphic trick, borrowed from 
Keynote: the old-to new user transition appears as faces on a 
rotating cube, 

iDisk now lets you work on a local copy of files, then 
automatically syncs them back to your iDisk. This is especially 
handy if you work on iDisk Files from more than one Mac, as 
your latest changes will always be available* 

New security features include FileVauJf, which automatically 
puts 128-bit encryption on files in your home directory, and 
Secure Empty Trash, which writes random data where your files 
used to be when you empty Lhe trash. 

One of the few downers during Steve's speech came when 
he said that Panther would be available "before the end of the 
year' 1 , which sounds later than many folks had heen guessing. 
However, Apple shipped a developer preview release at WWDC, 
which should be available to Select and Premier members of the 
Apple Developer Connection. 

News You Can Reaixy Use 

After finishing the OS X Panther stuff, Steve introduced 
Xcode, Apple's new development environment. Xcode is the 
successor to Project Builder, and it's made for speed and 
productivity. Xcode includes a new g cc 3-3 compiler that closes 
much of the speed gap it used to suffer from when compared to 
CodeWarrior: now, instead of being 10 times slower when 
compiling the Finder, it’s less than twice as slow', which 
definitely counts as progress. 

Jobs described Xcode's distributed builds feature, which 
uses Rendezvous to find idle computing resources on the local 
net and puts them to work building big projects in order to 
speed up project turnaround time. That's pretty cool. 

Next, Steve talked about how Xcode removes the linking 
phase for debug builds, improving turnaround time while you're 
in the code-build-crash-debug cycle of development At this fxmt, 
one clever nerd shouted out "now take out debugging! 1 ', Now 
what fun would that be? In another attempt to speed up your life, 
Xcode precompiles your I leaders while you're slil! typing in the 
rest of your code, which can save lots of compile time. 


After announcing Xcode, Steve called up Chris Espinosa, 
who has worked at Apple for more than half bis life (though not 
just on this project) to show how it works. Chris demonstrated 
an Xcode feature called Fix & Continue that lets you change an 
application while it's running, ihen see the change in the 
running app. While not quite folly interactive, Fix & Continue is 
handy for making various edits and changes and then viewing 
the results immediately. Chris showed a flower-drawing app 
that was only displaying one petal per flower, which is hardly 
pretty enough for an Apple demo, Using Fix & Continue, he 
changed the number of petals per flower (a constant) and we 
could see the result almost instantly, without having to stop and 
explicitly rebuild the app. Chns then upped the ante by 
changing the constant to a function call, and Fix & Continue 
worked just as well. 

Finally, Chris showed the now-familiar search box (just like 
the ones in tTunes and the Panther Finder) as a way to instantly 
search for files in your Xcode project. Many long-Li me Mac 
developers have never been able to warm to Project Builder, due 
to a number of issues that include poor performance, tricky user 
interface, and inertia. Xctxle is dearly designed to make those 
developers think again about switching to Apple's tools. 

Watch for much more detail about Xcode in Dave Mark's 
column next issue. 

As Always, One More Thing 

With the Panther and Xcode announcements successfully 
out of the way, Jobs turned to his trademark "One more thing...' 1 
schtick to issue the day's biggest news: the PowerMac G5, which 
Apple calls "the world fastest personal computer". Jobs 
acknowledged that G5 specs had been mistakenly leaked onto 
Apple's own web site days earlier, then nicely spun the leak by 
pointing out that although some thought the specs were too 
good to 1 jc true, they really were accurate after all. 

Jobs described the partnership with IBM that led up to 
the creation of the 64-bit G5 chip, which IBM calls PowerPC 
970. The raw specs are pretty cool: up to 2 GHz clock speed, 
with 3 Gllz promised within a year; 1 GHz front-side bus; 
massively parallel architecture that can have an incredible 
215 instructions in flight at once; dual floating point units; 
and a super-duper dual pipeline Velocity Engine. Jobs 
brought out IBM Vice President John Kelly, who looked only 
slightly out of place at an Apple shindig (jacket, no tie) and 
talked about the $3 billion factory that IBM uses to make 
these puppies. 

After announcing the G5 chip itself, Steve described the 
system Apple built Lo go around il. This includes a clever system 
controller that speeds tilings up in a number of ways, including 
dedicated bandwidth for main memory, fast PCI and PQ-X slots, 
and huge expansion, including up to 8 Gb RAM. 

With the chip and geeky system details described, the new 
Power Mac G5 arose like a golden calf from a previously hidden 
pedestal on the stage. The aluminum design is boxier than 
previous Power Macs, and features lots of little holes to help 
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Beat the Heat! 

Don't sweat it. Jack up the AC 
and chill out with these cool, 
new summer releases 
designed to help you make 
the most of your Mac. 


The Little Mac iApps Book 

By John Tollett with Robin Williams 
0-321-18747-4 * $21.99 

The Mac OS X Conversion Kit: 9 to 
10 Side by Side 
By Scott Kelby 
0-7357-1354-5 • $29.99 

The Macintosh iLife 

By Jim Heid 
0-321-17011-3 • $29.99 

Final Cut Express for Mac OS X: 
Visual QuickStart Guide 
By Lisa Brenneis 
0-321-19912-X • $21.99 

Apple Pro Training Series: Shake 3 
By Marco Paolini 
0-321-19725-9 • $44.99 

Making Movies with 
Final Cut Express 

By Michael Rubin 
0-321-19777-1 • $29,99 

Mac OS X Security 
By Bruce Potter, Preston Norvell 
and Brian Wotring 
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JavaScript for the World Wide 
Web, Fifth Edition: Visual 
QuickStart Guide 
By Tom Negrino and Dori Smith 
0-321-19439-X • $21.99 


Save up to 30%! Become a Peachpit Club Member today! 

Enjoy 10% off all books every day at 
peachpit.com, earn an additional 10% discount 
as a Peachpit Club Member, and save 10% on top 
of that with this one-time coupon! Simply go to 
www.peachpit.com/mactech703 and enter coupon 
code EM-73AA-MTMF at checkout. It’s that easy! 






















Whistle Blower 

Enterprise server monitor and restart utility 
whistleblowensentman.com 

Connect to and validate the response from web servers, 
cgi scripts and over 23 other types of servers. 

Send email, pages and perform unattended restarts via 
MasterSwitch or PowerKey 

Shifts make sure that the person on call when the server 
goes down is the one who gets the page. 

68k , PPC and Carbon 

Web based administration lets you check on and restart 
your servers from anywhere. 

Customize your response to an outage with Apple Script. 

email us at whistleblower@sentman.com 


ventilate those heat-producing G3s (see Figure 6). In fact, the 
G5 has nine fans for cooling, an announcement that brought ;i 
groan from the audience that has suffered with "wind-tunnel" 
G4s. Steve explained that the fan armada is controlled by 
software, not jusi dumb sensors, which will actually lead to 
quieter computers, but many in the crowd .seemed to lx. 1 
skeptical and adopted a wait-and-see (or, more accurately, wait- 
and-hear) attitude. 
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www.mactech.com 



Figure 6. PowerMac G'5. 7 bis is the front, which includes 
several fmrts for easy ac cess. 

The coolest parts of Steve's G5 demo were the "bake-offs" 
and charts that compared its speed to various Pentium and 
Zeon configurations. This lime, the claims included a new 
wrinkle: an independent testing house that verified Apples 
"fastest personal computer" boast. Those claims were much 
debated following the keynote: one key question was whether 
the tests used the best C compiler fur the Intel machines. Bui 
nit-picking aside, it's dear that for the first lime in a long while, 
the PowerMac G5 finally restores Apple to a competitive 
position in raw system speed, 

Steve is RkaixyJust Like Us 

After the keynote, I returned to the high tech bathroom 
facilities. As 1 was drying my hands at the sink, who should 
bound into view but the man himself, Steve Jobs. I said hi, he 
said hi, and I walked out of the bathroom as he stood at the 
sink. As I walked out, I heard the whirr of the automatic paper 
towel dispenser, followed by the sound of Steve chuckling in 
amusement. So here's the early rumor: look for Apple to ship 
automated paper towel dispensing hardware in every 
PowerMac G6. 
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Want to connect your development teams seamlessly? 
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Use Perforce or Spin your wheels 
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Other systems require an army of consultants, 
months of hacking, and probably the odd dab 
of crazy glue. With Perforce, nationwide and 
worldwide development teams can focus on 
working together without worrying about 
holding it together. 

Work anywhere. Requiring only TCP/IR Perforce 
mates use of a well-tuned streaming message protocol 
for synchronizing client workspaces with server 
repository contents. And the Perforce Proxy offers 
caching to provide remote users with quick download 
limes while maintaining real-time access to project 
activity and status information. 


With Perforce, tfw fast way is the tight way Install it 
fast, learn it fast, run it fast With other SCM systems, 
developers face an unpleasant choice: do it the right 
way or do ft the fast way. Perforce's speed and reach 
mean llie fast way is the right way. See how Perforce 
compares with other leading SCM systems ad 
htto^wwwporforce.corri/pc^orce/reviews.htm I 

Ron at fuff speed even with hundreds of users and 
minions of f&es. At the com of Perforce lies a relational 
database with welMcRyed tehles, so norma! user activity 
can he accomplished in near-zero time. Larger 
operations (like labeling a release and branching) are 
translated into keyed data access, giving Perforce the 
scalability that big projects require. 


Develop and maintain multiple codelines. Perforce's 
Inter-File Brandling lets you merge new features and 
apply fixes across oodelines. Smart metadata keeps 
track of your evolving projects even while they are 
developed in parallel. 

Truty cross platform, Perforce runs on more than 
50 operating systems, including Windows’, UNIX', 
Linux", Mac OS X, AS/400, and more. 

Integrate with hading IDEs and defect trackers: 

Visual Studio.NET', Visual C++ H . Visual Basic", 
JBuilder, CodeWamor, TeamTrack, Bugzilta™, 
ControlCenteC, DevTrack packages, plus more. 


Perforce 

software 

Fast Software Configuration Management www.perforce.com 
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Revolution 2.0: the English like language designed around the way you think. 
Develop and deliver on Mac OS X, Windows and Linux 
(not to mention 10 other platforms). 

Take the English language, add elegant XML, more SQL databases than you care to learn, 
intrinsic video capture, Unicode, CGI scripting, sophisticated Reports, and build your solution faster than anyone else. 
Jaguar, Panther, XP? Revolution lets you eat platforms for breakfast. And speaking of eating, our Cookbook of exam ples 
gets you up, running, and productive NOW. You can join the Revolution for as little as $99... 

Build with it f deliver with it, love it - and still have time for vacations. 

And for a limited time, your MacTech special lets you get 100% of the Revolution for 15% off - 
go to special.runrev.com NOW. Thousands of developers have already joined. 

Don't let the Revolution in modern coding start without you... 


Software At The Speed Of Thought 

D > RUNTIME 

WSk' Drvniimftii 


: ' . Software Development & Consultancy 

Runtime Revolution * 91 Hanover Street ♦ Edinburgh EH2 1 DJ • UK 
Phone +44 (0)131 718 4333 • Fax +44 (0)131 718 4334 • www.runrev.com ♦ Email info@runrev.com 
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